SpringMVC框架笔记整理（三）: 注解式控制器-数据处理

请求参数数据映射限定

@RequestMapping(params="create", method=RequestMethod.GET)
public String showForm() {
System.out.println("===============showForm");
return "parameter/create";
}

@RequestMapping(params=”create”, method=RequestMethod.GET) ：表示请求中有“create”的参数名且请求方法为“GET”即可匹配，如可匹配的请求URL“http://×××/parameter1?create”；

//请求参数不包含 create参数名，进行类级别的@RequestMapping窄
@RequestMapping(params="!create", method=RequestMethod.GET)

/**
表示请求中的有“test1”参数名 且 有“test2=create”参数即可匹配，
如可匹配的请求URL“http://×××/parameter3?test1&test2=create。
*/
@RequestMapping(params={"test1", "test2=create"})

数据绑定

1、@RequestParam绑定单个请求参数值；

2、@PathVariable绑定URI模板变量值；

3、@CookieValue绑定Cookie数据值

4、@RequestHeader绑定请求头数据；

5、@ModelValue绑定参数到命令对象；

6、@SessionAttributes绑定命令对象到session；

7、@RequestBody绑定请求的内容区数据并能进行自动类型转换等。

8、@RequestPart绑定“multipart/data”数据，除了能绑定@RequestParam能做到的请求参数外，还能绑定上传的文件等

除了上边提到的注解，可以通过如HttpServletRequest等API得到请求数据，但推荐使用注解方式，因为使用起来更简单

Spring Web MVC 提供Model、Map或ModelMap让我们能去暴露渲染视图需要的模型数据

@RequestMapping(value = "/model")
public String createUser(Model model, Map model2, ModelMap model3) {
model.addAttribute("a", "a");
model3.put("c", "c");
System.out.println(model2 == model3);
return "success";
}

AnnotationMethodHandlerAdapter和RequestMappingHandlerAdapter 使用BindingAwareModelMap作为模型对象的实现，即此处我们的形参 （Model model, Map model2, ModelMap model3）都是同一个BindingAwareModelMap实例。

//添加模型数据
model.addAttribute("a", "a");

ModelAndView mv = new ModelAndView("success");
//在视图渲染之前更新同名"a"的模型数据
mv.addObject("a", "update");

//修改同名模型数据
model.addAttribute("a", "new");

// 视图页面的a将显示为"update" 而不是"new"

处理方法的返回值中的模型数据（如ModelAndView）会 合并 功能处理方法形式参数中的模型数据（如Model），但如果两者之间有同名的，返回值中的模型数据会覆盖形式参数中的模型数据

1、请求参数绑定 @RequestParam





如/hello3/?username=zhang

2、绑定URI模版变量值@PathVariable

用于将请求URL中的模板变量映射到功能处理方法的参数上

数据类型转换

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



流程：

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

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

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

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



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

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

③：格式化显示：在表单页面可以通过如下方式展示通过内部通过Converter SPI格式化的数据和错误信息：

Converter SPI (类型转换器)：用于数据类型转换

Formatter SPI (格式化转换器)：通常需要将数据转换为具有某种格式的字符串进行展示，进行数据格式化服务、

首先需要通过如上taglib指令引入spring的两个标签库。

<%@taglib prefix="spring" uri="http://www.springframework.org/tags" %>
<%@taglib prefix="form" uri="http://www.springframework.org/tags/form" %>

Spring内建的类型转换器

第一组：标量转换器

类名	说明
StringToBooleanConverter	String—–>Boolean true:true/on/yes/1; false:false/off/no/0
ObjectToStringConverter	Object—–>String 调用toString方法转换
StringToNumberConverterFactory	String—–>Number（如Integer、Long等）
NumberToNumberConverterFactory	Number子类型<——>Number子类型(Integer、Long、Double等)
StringToCharacterConverter	String —–>java.lang.Character 取字符串第一个字符
NumberToCharacterConverter	Number子类型(Integer、Long、Double等)——> java.lang.Character
CharacterToNumberFactory	java.lang.Character ——>Number子类型(Integer、Long、Double等)
StringToEnumConverterFactory	String—–>enum类型 通过Enum.valueOf将字符串转换为需要的enum类型
EnumToStringConverter	enum类型—–>String 返回enum对象的name()值
StringToLocaleConverter	String—–>java.util.Local
PropertiesToStringConverter	java.util.Properties—–>String 默认通过ISO-8859-1解码
StringToPropertiesConverter	String—–>java.util.Properties 默认使用ISO-8859-1编码

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

类名	说明
ArrayToCollectionConverter	任意S数组—->任意T集合（List、Set）
CollectionToArrayConverter	任意T集合（List、Set）—->任意S数组
ArrayToArrayConverter	任意S数组<—->任意T数组
CollectionToCollectionConverter	任意T集合（List、Set）<—->任意T集合（List、Set） 即集合之间的类型转换
MapToMapConverter	Map<—->Map之间的转换
ArrayToStringConverter	任意S数组—->String类型
StringToArrayConverter	String—–>数组 默认通过“,”分割，且去除字符串的两边空格(trim)
ArrayToObjectConverter	任意S数组—->任意Object的转换 (如果目标类型和源类型兼容，直接返回源对象；否则返回S数组的第一个元素并进行类型转换)
ObjectToArrayConverter	Object—–>单元素数组
CollectionToStringConverter	任意T集合（List、Set）—->String类型
StringToCollectionConverter	String—–>集合（List、Set） 默认通过“,”分割，且去除字符串的两边空格(trim)
CollectionToObjectConverter	任意T集合—->任意Object的转换 (如果目标类型和源类型兼容，直接返回源对象；否则返回S数组的第一个元素并进行类型转换)
ObjectToCollectionConverter	Object—–>单元素集合

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

类名	说明
ObjectToObjectConverter	Object（S）—–>Object（T） 首先尝试valueOf进行转换、没有则尝试new 构造器(S)
IdToEntityConverter	Id(S)—–>Entity(T) 查找并调用public static T findEntityName获取目标对象，EntityName是T类型的简单类型
FallbackObjectToStringConverter	Object—–>String ConversionService 作为恢复使用，即其他转换器不能转换时调用（执行对象的toString()方法）

S：代表源类型，T：代表目标类型

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

数据格式化

格式化转换器：提供格式化转换的实现支持。



1、Printer接口：格式化显示接口，将T类型的对象根据Locale信息以某种格式进行打印显示（即返回字符串形式）；

package org.springframework.format;
public interface Printer<T> {
String print(T object, Locale locale);
}

2、Parser接口：解析接口，根据Locale信息解析字符串到T类型的对象；

package org.springframework.format;
public interface Parser<T> {
T parse(String text, Locale locale) throws ParseException;
}

解析失败可以抛出java.text.ParseException或IllegalArgumentException异常即可。

3、Formatter接口：格式化SPI接口，继承Printer和Parser接口，完成T类型对象的格式化和解析功能；

package org.springframework.format;
public interface Formatter<T> extends Printer<T>, Parser<T> {
}

4、AnnotationFormatterFactory接口：注解驱动的字段格式化工厂，用于创建带注解的对象字段的Printer和Parser，即用于格式化和解析带注解的对象字段。

package org.springframework.format;

public interface AnnotationFormatterFactory<A extends Annotation> {//①可以识别的注解类型
//②可以被A注解类型注解的字段类型集合
Set<Class<?>> getFieldTypes();

//③根据A注解类型和fieldType类型获取Printer
Printer<?> getPrinter(A annotation, Class<?> fieldType);

//④根据A注解类型和fieldType类型获取Parser
Parser<?> getParser(A annotation, Class<?> fieldType);
}

返回用于格式化和解析被A注解类型注解的字段值的Printer和Parser。如JodaDateTimeFormatAnnotationFormatterFactory可以为带有@DateTimeFormat注解的java.util.Date字段类型创建相应的Printer和Parser进行格式化和解析。

Spring内建的格式化转换器

类名	说明
DateFormatter	java.util.Date<—->String 实现日期的格式化/解析
NumberFormatter	java.lang.Number<—->String 实现通用样式的格式化/解析
CurrencyFormatter	java.lang.BigDecimal<—->String 实现货币样式的格式化/解析
PercentFormatter	java.lang.Number<—->String 实现百分数样式的格式化/解析
NumberFormatAnnotationFormatterFactory	@NumberFormat注解类型的数字字段类型<—->String ①通过@NumberFormat指定格式化/解析格式 ②可以格式化/解析的数字类型：Short、Integer、Long、Float、Double、BigDecimal、BigInteger
JodaDateTimeFormatAnnotationFormatterFactory	@DateTimeFormat注解类型的日期字段类型<—->String ①通过@DateTimeFormat指定格式化/解析格式 ②可以格式化/解析的日期类型： joda中的日期类型（org.joda.time包中的）：LocalDate、LocalDateTime、LocalTime、ReadableInstant java内置的日期类型：Date、Calendar、Long classpath中必须有Joda-Time类库，否则无法格式化日期类型

NumberFormatAnnotationFormatterFactory 和JodaDateTimeFormatAnnotationFormatterFactory（如果classpath提供了Joda-Time类库）在使用格式化服务实现DefaultFormattingConversionService时会自动注册。

@NumberFormater：定义数字相关的解析/格式化元数据（通用样式、货币样式、百分数样式），参数如下：

style：用于指定样式类型，包括三种：Style.NUMBER（通用样式） Style.CURRENCY（货币样式） Style.PERCENT（百分数样式），默认Style.NUMBER；

pattern：自定义样式，如patter=”#,###”

@DateTimeFormat：定义日期相关的解析/格式化元数据，参数如下：

pattern：指定解析/格式化字段数据的模式，如”yyyy-MM-dd HH:mm:ss”

iso：指定解析/格式化字段数据的ISO模式，

包括四种：

ISO.NONE（不使用）

ISO.DATE(yyyy-MM-dd)

ISO.TIME(hh:mm:ss.SSSZ)

ISO.DATE_TIME(yyyy-MM-dd hh:mm:ss.SSSZ)，默认ISO.NONE；

style：指定用于格式化的样式模式，默认“SS”，具体使用请参考Joda-Time类库的org.joda.time.format.DateTimeFormat的forStyle的javadoc；

优先级： pattern 大于 iso 大于 style。