spring mvc4的日期/数字格式化、枚举转换

日期、数字格式化显示，是web开发中的常见需求，spring mvc采用XXXFormatter来处理，先看一个最基本的单元测试：

package com.cnblogs.yjmyzz.test;

import java.math.BigDecimal;
import java.util.Date;
import java.util.Locale;

import org.junit.Test;
import org.springframework.context.i18n.LocaleContextHolder;
import org.springframework.format.datetime.DateFormatter;
import org.springframework.format.number.CurrencyFormatter;
import org.springframework.format.support.DefaultFormattingConversionService;

public class FormatterTest {

    @Test
    public void testFormatter() {
        
        //设置上下语言的语言环境
        LocaleContextHolder.setLocale(Locale.US);
        
        //--------测试日期格式化----------
        Date d = new Date();
        DateFormatter dateFormatter = new DateFormatter();
        //按中文格式输出日期
        System.out.println(dateFormatter.print(d, Locale.CHINESE));//2014-10-30    
        
        DefaultFormattingConversionService conversionService = new DefaultFormattingConversionService();
        //添加前面的DateFormatter
        conversionService.addFormatter(dateFormatter);
        
        System.out.println(conversionService.convert(d, String.class));//Oct 30, 2014
        
        dateFormatter.setPattern("yyyy年MM月dd日");        
        System.out.println(conversionService.convert(d, String.class));//2014年10月30日
        
        // --------测试货币格式化-------------
        CurrencyFormatter currencyFormatter = new CurrencyFormatter();
        BigDecimal money = new BigDecimal(1234567.890);
        System.out.println(currencyFormatter.print(money, Locale.CHINA));//￥1,234,567.89
        conversionService.addFormatter(currencyFormatter);
        System.out.println(conversionService.convert(money, String.class));//$1,234,567.89    
        

    }

}

除了DateFormatter、CurrencyFormatter，常用还有的以下Formatter:

这些Formatter全都实现了接口org.springframework.format.Formatter<T>，web开发中使用起来很方便：

一、先在servlet-context.xml中参考下面的内容，修改配置：

    <mvc:annotation-driven    conversion-service="conversionService" />

    <bean id="conversionService"
        class="org.springframework.format.support.FormattingConversionServiceFactoryBean">        
    </bean>

二、dto类中，在需要设置格式化的字段上，打上相关的注解

    @NumberFormat(style=Style.CURRENCY)
    //@NumberFormat(pattern="#,###.00")
    double amount;    

    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    Date createTime;

三、jsp页面上，使用<spring:eval />标签绑定

  <td><spring:eval expression="c.amount" /></td>                  
  <td><spring:eval expression="c.createTime" /></td>

四、枚举问题

表单提交的html页面中，经常会遇到一些诸如：性别(男、女) 的RadioButton组，背后通常对应Enum，表单提交的是String，默认情况下并不能自动映射成Model中的Enum成员，需要额外的Converter处理

4.1 先定义一个基本的枚举

package com.cnblogs.yjmyzz.enums;

public enum SEX {

    /**
     * 男
     */
    Male("1", "男"),

    /**
     * 女
     */
    Female("-1", "女"),

    /**
     * 保密
     */
    Unknown("0", "保密");

    private final String value;

    private final String description;

    private SEX(String v, String desc) {
        this.value = v;
        this.description = desc;
    }

    public String getValue() {
        return value;
    }

    public String getDescription() {
        return description;
    }

    public static SEX get(String strValue) {
        for (SEX e : values()) {
            if (e.getValue().equals(strValue)) {
                return e;
            }
        }
        return null;
    }

    @Override
    public String toString() {
        return this.value;
    }

}

保存到db中时，性别字段我们希望"男"存成"1"，"女"存成"-1"，"保密"存成"0"（当然，这只是个人喜好，仅供参考）

4.2 定义SEX枚举的Converter

package com.cnblogs.yjmyzz.convertor;

import org.springframework.core.convert.converter.Converter;
import com.cnblogs.yjmyzz.enums.SEX;

public class String2SexConvertor implements Converter<String, SEX> {

    @Override
    public SEX convert(String enumValueStr) {
        String value = enumValueStr.trim();
        if (value.isEmpty()) {
            return null;
        }
        return SEX.get(enumValueStr);
    }
}

代码很短，不多解释，Convert方法，完成类似 "1" -> SEX.Male的转换

4.3 配置修改

    <bean id="conversionService"
        class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
        <property name="converters">
            <set>
                <bean class="com.cnblogs.yjmyzz.convertor.String2SexConvertor" />
            </set>
        </property>
    </bean>

只需要在刚才的conversionService加上自己的Converter就行

4.4 form页面上的绑定示例：

<form:radiobuttons path="sex" items="${sexMap}" delimiter="&nbsp;" />

sexMap是ModelAndView中的一个属性，参考代码如下：

package com.cnblogs.yjmyzz.repository;

import java.util.EnumSet;
import java.util.HashMap;
import java.util.Map;

import com.cnblogs.yjmyzz.enums.SEX;

public class EnumRepository {
    static Map<String, String> sexMap = null;

    public static Map<String, String> getSexMap() {
        if (sexMap == null) {
            sexMap = new HashMap<String, String>();
            EnumSet<SEX> sexs = EnumSet.allOf(SEX.class);
            for (SEX sex : sexs) {
                sexMap.put(sex.getValue(), sex.getDescription());
            }
        }
        return sexMap;
    }

}

Action中，这样写：

    @RequestMapping(value = "edit/{id}")
    public ModelAndView edit(@PathVariable int id, HttpServletRequest request,
            HttpServletResponse response) throws Exception {
        ModelAndView model = new ModelAndView();
        Order order = orderService.get(id + "");
        model.addObject("sexMap", EnumRepository.getSexMap());//枚举列表,便于页面绑定
        model.addObject("data", order);
        model.setViewName("orders/edit");
        return model;
    }

4.5 页面显示时，如何转义

就刚才的示例而言，性别“男”，对应SEX.Male，自定义值是"1"，自定义描述是“男”，默认情况下${model.sex}显示成Male，如果想显示“自定义值”或“自定义描述”，不考虑国际化的话，直接调用value或description属性即可，参考下面的内容：

<td>${c.sex}/${c.sex.description}/${c.sex.value}</td>

最终显示成： Male/男/1