【SpringMVC】SpringMVC系列13之关于 mvc:annotation-driven

13、关于 mvc:annotation-driven

13.1、概述

会自动注册RequestMappingHandlerMapping、RequestMappingHandlerAdapter 与ExceptionHandlerExceptionResolver 三个bean。还将提供以下支持：

支持使用 ConversionService 实例对表单参数进行类型转换。
支持使用 @NumberFormat annotation、@DateTimeFormat注解完成数据类型的格式化。
支持使用 @Valid 注解对 JavaBean 实例进行 JSR 303 验证。
支持使用 @RequestBody 和 @ResponseBody 注解。

13.2、@InitBinder

由 @InitBinder 标识的方法，可以对 WebDataBinder 对象进行初始化。WebDataBinder 是 DataBinder 的子类，用于完成由表单字段到 JavaBean 属性的绑定。@InitBinder方法不能有返回值，它必须声明为void。@InitBinder方法的参数通常是是 WebDataBinder。

13.3、数据格式化

FormattingConversionServiceFactroyBean 内部已经注册了:

NumberFormatAnnotationFormatterFactroy：支持对数字类型的属性使用 @NumberFormat 注解。
JodaDateTimeFormatAnnotationFormatterFactroy：支持对日期– 类型的属性使用 @DateTimeFormat 注解。
装配了 FormattingConversionServiceFactroyBean 后，就可以在 Spring MVC 入参绑定及模型数据输出时使用注解驱动了。
默认创建的ConversionService 实例即为FormattingConversionServiceFactroyBean。

13.4、日期格式化

@DateTimeFormat 注解可对java.util.Date、java.util.Calendar、java.long.Long 时间类型进行标注：

pattern 属性：类型为字符串。指定解析/格式化字段数据的模式，如："yyyy-MM-dd hh:mm:ss"。
iso 属性：类型为 DateTimeFormat.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)。
style 属性：字符串类型。通过样式指定日期时间的格式，由两位字符组成，第一位表示日期的格式，第二位表示时间的格式：S：短日期/时间格式、M：中日期/时间格式、L：长日期/时间格式、F：完整日期/时间格式、-：忽略日期或时间格式。

13.5、数值格式化

@NumberFormat 可对类似数字类型的属性进行标注，它拥有两个互斥的属性：

style：类型为 NumberFormat.Style。用于指定样式类型，包括三种：Style.NUMBER（正常数字类型）、Style.CURRENCY（货币类型）、 Style.PERCENT（百分数类型）。
pattern：类型为 String，自定义样式，如patter="#,###"。

即可自定义格式化，也可以使用SpringMVC自带格式转换器。

13.6、数据校验

JSR 303是 Java 为 Bean 数据合法性校验提供的标准框架，它已经包含在 JavaEE 6.0 中。JSR 303 通过在 Bean 属性上标注类似于 @NotNull、@Max等标准的注解指定校验规则，并通过标准的验证接口对 Bean 进行验证。

Hibernate Validator 扩展注解。Hibernate Validator 是 JSR 303 的一个参考实现，除支持所有标准的校验注解外，它还支持以下的扩展注解。

Spring 4.0 拥有自己独立的数据校验框架，同时支持 JSR 303 标准的校验框架。
Spring 在进行数据绑定时，可同时调用校验框架完成数据校验工作。在 Spring MVC 中，可直接通过注解驱动的方式进行数据校验。
Spring 的 LocalValidatorFactroyBean 既实现了 Spring 的Validator 接口，也实现了 JSR 303 的 Validator 接口。只要在 Spring 容器中定义了一个LocalValidatorFactoryBean，即可将其注入到需要数据校验的 Bean 中。
JSR303 的实现者的 jar 包放到类路径下。
会默认装配好一个LocalValidatorFactoryBean，通过在处理方法的入参上标注 @valid 注解即可让 Spring MVC 在完成数据绑定后执行数据校验的工作。
在已经标注了 JSR303 注解的表单/命令对象前标注一个@Valid，Spring MVC 框架在将请求参数绑定到该入参对象后，就会调用校验框架根据注解声明的校验规则实施校验。
Spring MVC 是通过对处理方法签名的规约来保存校验结果的：前一个表单/命令对象的校验结果保存到随后的入参中，这个保存校验结果的入参必须是 BindingResult 或Errors 类型，这两个类都位于org.springframework.validation 包中。