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