十、SpringMVC--数据格式化和数据校验

数据格式化

1. 对属性对象的输入输出进行格式化，从其本质讲依然属于“类型转换”的范畴。
2. Spring在格式化模块中定义了一个实现ConversionService接口的FormattingConversionService实现类，该实现类扩展了GenericConversionService，因此它既具有类型转换的功能，又有格式化的功能。
3. FormattingConversionService拥有一个FormattingConversionServiceFactoryBean工厂类，后者用于在Spring上下文中构造前者。
4. FormattingConversionServiceFactoryBean内部已经注册了：
   -NumberFormatAnnotationFormatterFactroy：支持对数字类型的属性使用 @NumberFormat 注解。
   -JodaDateTimeFormatAnnotationFormatterFactroy：支持对日期类型
   的属性使用 @DateTimeFormat 注解。
5. 装配了FormattingConversionServiceFactoryBean后，就可以在SpringMVC入参绑定及模型数据输出时使用注解驱动了。mvc:annotation-driven/ 默认创建的ConversionService 实例即为
   FormattingConversionServiceFactroyBean。

日期格式化

@DataTimeFormat注解

@DataTimeFormat注解可对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：完整日期/时间格式、-：忽略日期或时间格式。

数值格式化

@NumberFormat

@NumberFormat可以对类似数字类型的属性进行标注，它拥有两个互斥的属性：
-style：类型为NumberFormatStyle。用于指定样式类型，包括三种：Style.NUMBER（正常数字类型）、Style.CURRENCY（货币类型）、Style.PERCENT（百分数类型）。
-pattern:类型为String，自定义样式，如pattern="#,###";

数据格式化示例

数据校验------JSR 303

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

Hibernate Validator 扩展注解

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

Spring MVC 数据校验

1. Spring4.0拥有自己独立的数据校验框架，同时支持JSR303标准的校验框架。
2. Spring在进行数据绑定时，可同时调用校验框架完成数据校验工作。在SpringMVC中，可直接通过注解驱动的方式进行数据校验。
3. Spring的LocalValidatorFactoryBean既实现了Spring的Validator接口，也实现了JSR303的Validator接口。只要在Spring容器中定义了一个LocalValidatorFactoryBean,即可将其注入到需要数据校验的Bean中。
4. Spring本身并没有提供JSR303的实现，所以必须将JSR303的实现者的jar包放到类路径下。

Spring MVC 数据校验

5. mvc:annotation-driven/会默认装配好一个LoalValidatorFactoryBean,通过在处理方法的入参上标注@Valid注解即可让Spring MVC在完成数据绑定后执行数据校验的工作。
6. 在已经标注了JSR303注解的表单/命令对象前标注一个@Valid,SpringMVC框架在将请求参数绑定到该入参对象后，就会调用校验框架根据注解声明的校验规则实施校验。
7. SpringMVC是通过对处理方法签名的规约来保存校验结果的：前一个表单/命令对象的校验结果是保存到随后的入参中，这个保存校验结果的入参必须是BindingResult或Errors类型，这两个类都位于org.springframework.validation 包中。
8. 需校验的Bean对象和其绑定结果对象或错误对象是成对出现的，他们之间不予许声明其他的入参。
9. Errors接口提供了获取错误信息的方法，如getErrorCount()或getFieldErrors(String field).
10. BindingResult扩展了Errors接口
    

在目标方法中获取校验结果

1. 在表单/命名对象的属性中标注校验注解，在处理方法对应的入参前添加@Valid,Spring MVC就会实施校验并将校验结果保存在被校验入参对象之后的BindingResult或Errors入参中。
2. 常用的方法：
   – FieldError getFieldError(String field)
   – List getFieldErrors()
   – Object getFieldValue(String field)
   – Int getErrorCount()

在页面上显示错误

1. Spring MVC除了会将表单/命令对象的校验结果保存到对应的BindingResult或Erors对象中外，还会将所有的校验结果保存到“隐含模型”。
2. 即使处理方法的签名中没有对应于表单/命令对象的结果入参，校验结果也会保存在“隐含对象”中。
3. 隐含模型中的所有数据最终将通过HttpServletRequest的属性列表暴露给JSP视图对象，因此在JDP中可以获取错误信息。
4. 在JSP页面上可以通过<form:errors path=“userName”>显示错误信息。

示例

Employee.java:

public class Employee {
   

	private Integer id;
	@NotEmpty
	private String lastName;

	@Email
	private String email;
	//1 male, 0 female
	private Integer gender;
	
	private Department department;
	
	@Past
	@DateTimeFormat(pattern="yyyy-MM-dd")
	private Date birth;
	
	@NumberFormat(pattern="#,###,###.#")
	private Float salary;

	public Integer getId() {
   
		return id;
	}

	public void