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

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

 1 package com.cnblogs.yjmyzz.test;
 2
 3 import java.math.BigDecimal;
 4 import java.util.Date;
 5 import java.util.Locale;
 6
 7 import org.junit.Test;
 8 import org.springframework.context.i18n.LocaleContextHolder;
 9 import org.springframework.format.datetime.DateFormatter;
10 import org.springframework.format.number.CurrencyFormatter;
11 import org.springframework.format.support.DefaultFormattingConversionService;
12
13 public class FormatterTest {
14
15     @Test
16     public void testFormatter() {
17
18         //设置上下语言的语言环境
19         LocaleContextHolder.setLocale(Locale.US);
20
21         //--------测试日期格式化----------
22         Date d = new Date();
23         DateFormatter dateFormatter = new DateFormatter();
24         //按中文格式输出日期
25         System.out.println(dateFormatter.print(d, Locale.CHINESE));//2014-10-30
26
27         DefaultFormattingConversionService conversionService = new DefaultFormattingConversionService();
28         //添加前面的DateFormatter
29         conversionService.addFormatter(dateFormatter);
30
31         System.out.println(conversionService.convert(d, String.class));//Oct 30, 2014
32
33         dateFormatter.setPattern("yyyy年MM月dd日");
34         System.out.println(conversionService.convert(d, String.class));//2014年10月30日
35
36         // --------测试货币格式化-------------
37         CurrencyFormatter currencyFormatter = new CurrencyFormatter();
38         BigDecimal money = new BigDecimal(1234567.890);
39         System.out.println(currencyFormatter.print(money, Locale.CHINA));//￥1,234,567.89
40         conversionService.addFormatter(currencyFormatter);
41         System.out.println(conversionService.convert(money, String.class));//$1,234,567.89
42
43
44     }
45
46 }

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

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

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

1     <mvc:annotation-driven    conversion-service="conversionService" />
2
3     <bean id="conversionService"
4         class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
5     </bean>

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

1     @NumberFormat(style=Style.CURRENCY)
2     //@NumberFormat(pattern="#,###.00")
3     double amount;
4
5     @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
6     Date createTime;

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

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

四、枚举问题

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

4.1 先定义一个基本的枚举

 1 package com.cnblogs.yjmyzz.enums;
 2
 3 public enum SEX {
 4
 5     /**
 6      * 男
 7      */
 8     Male("1", "男"),
 9
10     /**
11      * 女
12      */
13     Female("-1", "女"),
14
15     /**
16      * 保密
17      */
18     Unknown("0", "保密");
19
20     private final String value;
21
22     private final String description;
23
24     private SEX(String v, String desc) {
25         this.value = v;
26         this.description = desc;
27     }
28
29     public String getValue() {
30         return value;
31     }
32
33     public String getDescription() {
34         return description;
35     }
36
37     public static SEX get(String strValue) {
38         for (SEX e : values()) {
39             if (e.getValue().equals(strValue)) {
40                 return e;
41             }
42         }
43         return null;
44     }
45
46     @Override
47     public String toString() {
48         return this.value;
49     }
50
51 }

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

4.2 定义SEX枚举的Converter

 1 package com.cnblogs.yjmyzz.convertor;
 2
 3 import org.springframework.core.convert.converter.Converter;
 4 import com.cnblogs.yjmyzz.enums.SEX;
 5
 6 public class String2SexConvertor implements Converter<String, SEX> {
 7
 8     @Override
 9     public SEX convert(String enumValueStr) {
10         String value = enumValueStr.trim();
11         if (value.isEmpty()) {
12             return null;
13         }
14         return SEX.get(enumValueStr);
15     }
16 }

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

4.3 配置修改

1     <bean id="conversionService"
2         class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
3         <property name="converters">
4             <set>
5                 <bean class="com.cnblogs.yjmyzz.convertor.String2SexConvertor" />
6             </set>
7         </property>
8     </bean>

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

4.4 form页面上的绑定示例：

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

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

 1 package com.cnblogs.yjmyzz.repository;
 2
 3 import java.util.EnumSet;
 4 import java.util.HashMap;
 5 import java.util.Map;
 6
 7 import com.cnblogs.yjmyzz.enums.SEX;
 8
 9 public class EnumRepository {
10     static Map<String, String> sexMap = null;
11
12     public static Map<String, String> getSexMap() {
13         if (sexMap == null) {
14             sexMap = new HashMap<String, String>();
15             EnumSet<SEX> sexs = EnumSet.allOf(SEX.class);
16             for (SEX sex : sexs) {
17                 sexMap.put(sex.getValue(), sex.getDescription());
18             }
19         }
20         return sexMap;
21     }
22
23 }

Action中，这样写：

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

4.5 页面显示时，如何转义

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

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

最终显示成： Male/男/1