04springMVC数据类型转换

• 数据类型转换简介
• Spring Web MVC中的数据类型转换
• 内建的类型转换器
• 自定义类型转换器

1      数据类型转换简介

当从页面提交数据到后台Action的时候，通过请求发送的数据，通常都是字符串类型的，不能满足后台Model中的数据类型的需要，因此需要进行数据类型转换。

从Spring3开始，我们可以使用如下架构进行类型转换、验证及格式化：

基本的流程：

①     类型转换：内部的ConversionService会根据S源类型/T目标类型自动选择相应的Converter SPI进行类型转换，而且是强类型的，能在任意类型数据之间进行转换；

②     数据验证：支持JSR-303验证框架，如将@Valid放在需要验证的目标类型上即可；

②     格式化显示：其实就是任意目标类型---->String的转换，完全可以使用Converter SPI完成。

Spring为了更好的诠释格式化/解析功能提供了Formatter SPI，支持根据Locale信息进行格式化/解析，而且该套SPI可以支持字段/参数级别的细粒度格式化/解析。

Formatter SPI最大特点是能进行字段/参数级别的细粒度解析/格式化控制，即使是Converter SPI也是粗粒度的（到某个具体类型，而不是其中的某个字段单独控制），目前Formatter SPI还不是很完善。Formatter SPI内部实现实际委托给Converter SPI进行转换，即约束为解析/格式化String<---->任意目标类型。

2      Spring Web MVC中的数据类型转换

在Spring Web MVC环境中，数据类型转换、验证及格式化通常是这样使用的：

①类型转换：首先表单数据（全部是字符串）通过WebDataBinder进行绑定到命令对象，内部通过Converter SPI实现；

②数据验证：使用JSR-303验证框架进行验证；

③格式化显示：展示通过Converter SPI格式化的数据和错误信息。

3      内建的类型转换器

第一组：标量转换器

1：StringToBooleanConverter ：String----->Boolean

如：true:true/on/yes/1； false:false/off/no/0

2：ObjectToStringConverter ：Object----->String ，调用toString方法转换

3：StringToNumberConverterFactory ：String----->Number（如Integer、Long等）

4：NumberToNumberConverterFactory ：Number子类型(Integer、Long、Double等)<——> Number子类型(Integer、Long、Double等)

5：StringToCharacterConverter ：String-->java.lang.Character，取字符串第一个字符

6：NumberToCharacterConverter ：Number子类型(Integer、Long、Double等)——> java.lang.Character

7：CharacterToNumberFactory ：java.lang.Character —>Number子类型(Integer、Long、Double等)

8：StringToEnumConverterFactory ：String----->enum类型，通过Enum.valueOf将字符串转换为需要的enum类型

9：EnumToStringConverter ：enum类型----->String，返回enum对象的name()值

10：StringToLocaleConverter ：String----->java.util.Local

11：PropertiesToStringConverter ：java.util.Properties----->String，默认通过ISO-8859-1解码

12：StringToPropertiesConverter ：String----->java.util.Properties，默认使用ISO-8859-1编码

第二组：集合、数组相关转换器

1：ArrayToCollectionConverter ：任意S数组---->任意T集合（List、Set）

2：CollectionToArrayConverter ：任意T集合（List、Set）---->任意S数组

3：ArrayToArrayConverter ：任意S数组<---->任意T数组

4：CollectionToCollectionConverter ：任意T集合（List、Set）<---->任意T集合（List、Set），即集合之间的类型转换

5：MapToMapConverter ：Map<---->Map之间的转换

6：ArrayToStringConverter ：任意S数组---->String类型

7：StringToArrayConverter ：String--->数组，默认“,”分割，且去除字符串的两边空格

8：ArrayToObjectConverter ：任意S数组---->任意Object的转换，(如果目标类型和源类型兼容，直接返回源对象；否则返回S数组的第一个元素并进行类型转换)

9：ObjectToArrayConverter ：Object----->单元素数组

10：CollectionToStringConverter ：任意T集合（List、Set）--->String类型

11：StringToCollectionConverter ：String----->集合（List、Set），默认通过“,”分割，且去除字符串的两边空格(trim)

12：CollectionToObjectConverter ：任意T集合---->任意Object的转换，(如果目标类型和源类型兼容，直接返回源对象；否则返回S数组的第一个元素并进行类型转换)

13：ObjectToCollectionConverter ：Object----->单元素集合

第三组：默认（fallback）转换器，之前的转换器不能转换时调用

1：ObjectToObjectConverter ：

Object（S）----->Object（T），首先尝试valueOf进行转换、没有则尝试new 构造器(S)

2：IdToEntityConverter ：

Id(S)----->Entity(T)，查找并调用public static T    find[EntityName](S)获取目标对象，EntityName是T类型的简单类型

3：FallbackObjectToStringConverter ：

Object----->String，ConversionService作为恢复使用，即其他转换器不能转换时调用（执行对象的toString()方法）

如上的转换器在使用转换服务实现DefaultConversionService和DefaultFormattingConversionService时会自动注册。

4      自定义类型转换器

通过一个示例来说明，实现自定义String--->PhoneNumberModel的转换器：

 

需求：将座机号码转换成区号和号码两个部分保存

1)         转换器

 package com.inspur.converter;
 
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 import org.springframework.core.convert.converter.Converter;
 import org.springframework.util.StringUtils;
 import com.inspur.pojo.PhoneNumberModel;
 
 public class StringToPhoneNumberConverter implements Converter<String, PhoneNumberModel> {
     Pattern pattern = Pattern.compile("^(\\d{3,4})-(\\d{7,8})$");
 
     public PhoneNumberModel convert(String source) {
         if (!StringUtils.hasLength(source)) {
             // ①如果source为空返回null
             return null;
         }
         Matcher matcher = pattern.matcher(source);
         if (matcher.matches()) {
             // ②如果匹配进行转换
             PhoneNumberModel phoneNumber = new PhoneNumberModel();
             phoneNumber.setAreaCode(matcher.group(1));
             phoneNumber.setPhoneNumber(matcher.group(2));
             return phoneNumber;
         } else {
             // ③如果不匹配转换失败
             throw new IllegalArgumentException(String.format(
                     "类型转换失败，需要格式[010-12345678]，但格式是[%s]", source));
         }
     }
 }

2)         使用的model

 public class PhoneNumberModel {
     private String areaCode;//区号
     private String phoneNumber;//电话号码
     //省略get/set……
 }

3)         简单的测试代码

 package com.inspur.test;
 import org.springframework.core.convert.support.DefaultConversionService;
 import com.inspur.converter.StringToPhoneNumberConverter;
 import com.inspur.pojo.PhoneNumberModel;
 public class ConverterTest {
     /**
      * 需求：将座机号码转换成区号和号码两个部分保存
      * @param args
      */
     public static void main(String[] args) {
         DefaultConversionService conversionService = new DefaultConversionService();
         conversionService.addConverter(new StringToPhoneNumberConverter());
         String phoneNumberStr = "010-12345678";
         PhoneNumberModel phoneNumber = conversionService.convert(phoneNumberStr, PhoneNumberModel.class);
         System.out.println("区号==" + phoneNumber.getAreaCode()+"  号码==" + phoneNumber.getPhoneNumber());
     }
 }

注册ConversionService实现和自定义的类型转换器

4)         集成到Spring Web MVC环境

 <!-- 注册ConversionService实现和自定义的类型转换器 -->
 <bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
     <property name="converters">
         <list>
             <bean class="com.inspur.converter.StringToPhoneNumberConverter" />
         </list>
     </property>
 </bean>

converters：注册我们自定义的类型转换器，此处注册了String--->PhoneNumberModel。FormattingConversionServiceFactoryBean：是FactoryBean实现，默认使用DefaultFormattingConversionService转换器服务实现；

• 在<mvc:annotation-drive>里面配置conversion-service属性

示例：<mvc:annotation-driven conversion-service="conversionService">