SpringMVC_数据转化、数据格式化、数据校验

港控/mmm° 2022-05-18 03:09 159阅读 0赞

### 一、数据绑定流程 ###

1、SpringMVC 主框架将 ServletRequest 对象及目标方法的入参实例传给 WebDataBinderFactory 实例，以创建 **DataBinder** 实例对象

2、DataBinder 调用装配在 SpringMVC 上下文中的 **ConversionService** 组件进行 数据类型转换、数据格式化 工作。将Servlet中的请求信息填充到入参对象中。

3、调用 **Validator** 组件对已经绑定了的请求消息的入参对象进行数据合法性校验，并最终生成数据绑定结果 BindingData 对象。

4、SpringMVC 抽取 **BindingResult** 中的入参对象和校验错误对象，将它们赋给处理方法的响应入参。

5、SpringMVC 通过**反射机制**对目标处理方法进行解析，将请求参数绑定到处理方法的入参中。数据绑定的核心部件是 **DataBinder**，运行机制如下：

![70][]

![70 1][]

![70 2][]

### 二、数据转换 ###

1、SpringMVC 上下文中内建了很多转换器，可完成大多数 Java类型的转换工作。

2、

ConversionService converters = 
    
    – java.lang.Boolean -> java.lang.String :
    org.springframework.core.convert.support.ObjectToStringConverter@f874ca
    – java.lang.Character -> java.lang.Number : CharacterToNumberFactory@f004c9
    – java.lang.Character -> java.lang.String : ObjectToStringConverter@68a961
    – java.lang.Enum -> java.lang.String : EnumToStringConverter@12f060a
    – java.lang.Number -> java.lang.Character : NumberToCharacterConverter@1482ac5
    – java.lang.Number -> java.lang.Number : NumberToNumberConverterFactory@126c6f
    – java.lang.Number -> java.lang.String : ObjectToStringConverter@14888e8
    – java.lang.String -> java.lang.Boolean : StringToBooleanConverter@1ca6626
    – java.lang.String -> java.lang.Character : StringToCharacterConverter@1143800
    – java.lang.String -> java.lang.Enum : StringToEnumConverterFactory@1bba86e
    – java.lang.String -> java.lang.Number : StringToNumberConverterFactory@18d2c12
    – java.lang.String -> java.util.Locale : StringToLocaleConverter@3598e1
    – java.lang.String -> java.util.Properties : StringToPropertiesConverter@c90828
    – java.lang.String -> java.util.UUID : StringToUUIDConverter@a42f23
    – java.util.Locale -> java.lang.String : ObjectToStringConverter@c7e20a
    – java.util.Properties -> java.lang.String : PropertiesToStringConverter@367a7f
    – java.util.UUID -> java.lang.String : ObjectToStringConverter@112b07f ……

**3、自定义数据类型转换**

1）** ****ConversionService** 是 Spring 类型转换体系的核心接口。

2）可以利用 **ConversionServiceFatoryBean** 在 Spring 的 IOC 容器中定义的一个 ConversionService 。**Spring 将自动识别出 IOC容器的 ConversionService ，并在 Bean属性配置和 SpringMVC 处理方法入参绑定等场合使用它进行数据的转换**。

3）可通过 ConversionServiceFactoryBean 的 converters 属性 注册自定义的类型转换器。

![70 3][]

4）Spring定义了3种类型的转换器接口，实现任意一个转换器接口都可以作为自定义转换器注册到ConversionServiceFactoryBean中：

*  **Converter<S,T>**：将s类型对象转化为t型类型对象
 *  ConverterFactory：将相同系列多个“同质”Converter封装在一起。如果希望将一种类型的对象转换为另一种类型及其子类对象（例如将String转化为Number及Number子类（Integer、Long、Double等）对象）可使用该转换器工厂。
 *  GenericConverter：会根据源类对象及目标类对象所在的宿主类中的上下文信息进行类型转化。

5）**<mvc:annotation-driven conversion-service=“conversionService”/>** 会将自定义的 ConversionService 注册到Spring MVC 的上下文中

![70 4][]

实例：

配置：

<mvc:annotation-driven conversion-service = "conversionService"></mvc:annotation-driven>
    
        
        <bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
            <property name="converters">
                <set>
                    <ref bean="employeeConverters"/>
                </set>
            </property>
        </bean>

转换类：

@Component
    public class EmployeeConverters implements Converter<String,Employee>{
        @Override
        public Employee convert(String s) {
            if (s!=null){
                String[] vals = s.split("-");
                if (vals != null && vals.length == 4 ){
                    String lastName=vals[0];
                    String email = vals[1];
                    Integer gender = Integer.parseInt(vals[2]);
                    Department department = new Department();
                    department.setId(Integer.valueOf(vals[3]));
                    Employee employee = new Employee(null,lastName,email,gender,department);
                    System.out.println(s+"--convert--"+employee);
                    return employee;
                }
            }
            return null;
        }
    }

### 三、关于mvc：annotation-driven ###

1、**<mvc:annotation-driven />** 会自动注册RequestMappingHandlerMapping、RequestMappingHandlerAdapter 与  
ExceptionHandlerExceptionResolver 三个bean。

2、还将提供以下支持：

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

①、既没有配置 <mvc:default-servlet-handler/> 也没有配置 <mvc:annotation-driven/>

![70 5][]

②、配置了 <mvc:default-servlet-handler/> 但没有配置 <mvc:annotation-driven/>

![70 6][]

③、既配置了 <mvc:default-servlet-handler/> 又配置 <mvc:annotation-driven/>

![70 7][]

## ##

### 四、@InitBinder ###

由 **@InitBinder** 标识的方法，可以对 **WebDataBinder** 对象进行初始化。WebDataBinder是 DataBinder 的子类，用于完成由表单字段到JavaBean属性的绑定。

*  InitBinder方法不能有返回值。它必须声明为void
 *  InitBinder方法的参数通常是 WebDataBinder

![70 8][]

### 五、数据格式化 ###

1、对属性对象的输入、输出进行格式化，从其本质上讲依然属于“类型转换”的范畴。

2、Spring 在格式化模块中定义了一个实现 ConversionService 接口的 **FormattingConversionService** 实现类，该实现类扩展了GenericConversionService，因此它**即具有类型转换的功能，又具有格式化的功能**。

3、**FormattingConversionServiceFactoryBean** 工厂类，后者用于在Spring上下文中构造前者。

4、FormattingConversionServiceFactoryBean 内部已经注册了：

*  NumberFormatAnnotationFormatterFactory：支持对数字类型的属性使用 **@NumberFormat** 注解
 *  JodaDateTimeFormatAnnotationFormatterFactory：支持对日期类型的属性使用 **@DataTimeFormat** 注解

5、装配了 FormattingConversionServiceFactoryBean 后，就可以在 SpringMVC 入参绑定及模型数据输出时使用注解驱动了。

<mvc:annotation-driven/> 默认创建的ConversionService 实例即为FormattingConversionServiceFactroyBean  
**一）、日期格式化**

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

*  pattern属性：类型为字符串。指定解析、格式化字段数据的模式，如“yyyy-MM-dd hh:mm:ss”
 *  iso属性：类型为DateTimeFormat.ISO。指定解析、格式化字段数据的ISO模式，包括四种：ISOISO.NONE（不使用）、  
    \--默认、ISO.DATE(yyyy-MM-dd)、ISOISO.TIME(hh:mm:ss.SSZZ)、ISO.DATE\_TIME(yyyy-MM-dd hh:mm:ss.SSSZ)
 *  style属性：字符串类型。通过样式指定日期时间的格式，由两位字符组成，第一位表示日期的格式，第二位表示时间的格式，S：短日期/时间格式、M：中日期/时间格式、L：长日期/时间格式、F：完整日期/时间格式、-：忽略日期或时间格式

**二）、数值格式化**

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

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

![70 9][]

### 六、数据校验 ###

**一）、JSR 303**

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

![70 10][]

**二）、Hibernate Validator 扩展注解**

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

![70 11][]

**三）、SpringMVC 数据校验**

*  Spring 4.0 拥有自己独立的数据校验框架，同时支持 JSR 303标准的校验框架。
 *  Spring 在进行数据绑定的时候，可同时调用校验框架完成数据校验工作。在 SpringMVC中，可以直接通过注解驱动的方式进行数据校验。
 *  Spring 的LocalValidatorFactoryBean 即实现了 Spring的 Validator 接口，也实现了 JSR 303的Validator接口。只要在Spring容器中定义了一个 LocalValidatorFactoryBean ，即可将其注入到需要数据校验的Bean中。
 *  Spring 本身没有提供 JSR 303 的实现，所以必须将JSR 303的实现者的jar包放到类路径下。
 *  **<mvc:annotation-driven/> 会默认装配好一个LocalValidatorFactoryBean**，通过在处理方法的入参上标注 @Valid 注解即可让Spring MVC 在完成数据绑定后执行数据校验的工作。
 *  在已经标注了 JSR 303 注解的表单、命令对象前标准一个 @Valid，SpringMVC在将请求参数绑定到该入参对象后，就会调用校验框架根据注解声明的校验规则实施校验
 *  SpringMVC 是通过对处理方法签名的规约来保存校验结果的：前一个表单、命令对象的校验结果保存到随后的入参中，这个保存校验结果的入参必须是 **BindingResult** 或 **Errors** 类型，这两个类都位于org.springframework.validation 包中。
 *  需校验的Bean对象和其绑定的结果对象或错误对象成对出现的，他们之间不许声明其他的入参。
 *  Error接口提供了获取错误信息的方法，如getErrorCount ()或 getFieldErrors（String field）
 *  BindingResult扩展了Errors接口

![70 12][]

* 数据校验：
     * 1、如何校验？
     * ①、使用JSR 303 校验标准
     * ②、加入Hibernate Validator验证框架的jar包
     * ③、在SpringMVC的配置文件中加上<mvc:annotation-driven/>
     * ④、需要在bean上添加对应的注解
     * ⑤、在目标方法 bean类型的前面加上 @@Valid 注解
     * 2、若验证出错转向定制的页面
     * 注意：需校验的 Bean 对象和其绑定结果对象或错误对象时成对出现的，它们之间不允许声明其他的入参
     */
    @Valid
    public class Employee implements Serializable{
        private Integer id;
        @NotNull
        private String lastName;
        @Email
        private String email;

关于 @Valid和@Validate说明：

@Valid注解用于校验，所属包为：javax.validation.Valid。

①在对应的属性上添加相应的校验注解

②在controller层要校验的方法参数上添加 @Valid注解

@Validated是@Valid 的一次封装，是Spring提供的校验机制使用。@Valid不提供分组功能，@Validated提供了分组功能

**四）、在目标方法中获取校验结果**

*  在表单、命令对象类的属性中标注校验注解在处理方法对应的入参前加上 @Validate，SpringMVC就会实施校验并将校验结果保存在被校验入参对象之后的BingingResult 或 Errors入参中。
 *  常用方法：
    
     *  FieldError getFieldError(String field)
     *  List<FieldError> getFieldErrors()
     *  Object getFieldValue(String field)
     *  Int getErrorCount()

**五）、在页面上显示错误消息**

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

Email:<form:input path="email"/>
        <form:errors path="email"/>

**六）、提示消息的国际化**

1）每个属性在数据绑定和数据校验发生错误时，都会生成一个对应的 FieldError 对象。

2）当一个属性校验失败后，校验框架会为该属性生成4个消息代码，这些消息代码以校验注解类名为前缀，结合 ModelAttribute、属性名及属性类型名生成多个对应消息代码：例如User类中的password属性标准了一个 @Pattern 注解，当该属性不满足 @Pattern 所定义的规则的时候，就会产生如下4个错误代码：

*  Pattern.user.password
 *  Pattern.password
 *  Pattern.java.lang.String
 *  Pattern

3）当使用SpringMVC标签显示错误消息的时候，SpringMVC会查看Web上下文是否装配了对应的国际化消息，如果没有，则显示默认的错误信息，否则使用国际化消息。

4）若数据类型转换或数据格式转化时发生错误，或该有的参数不存在，或调用处理方法时发生错误，都会在隐含模型中创建错误消息。其错误代码前缀说明如下：

*  required：必要的参数不存在。如 @RequiredParam(“param1”) 标注了一个入参，但是该参数不存在
 *  typeMismatch：在数据绑定时，发生数据类型不匹配的问题
 *  methodInvocation：Spring MVC 在调用处理方法时发生了错误

5）注册国际化资源文件

![70 13][]

实例：

![70 14][]

<bean id="messageSource" class="org.springframework.context.support.ResourceBundleMessageSource">
            <property name="basename" value="i18n"/>
        </bean>

[70]: /images/20220518/99bae87b824741f1bee6170bcd5bb20a.png
[70 1]: /images/20220518/579f0549d85149be97074783acc0d75a.png
[70 2]: /images/20220518/55de4899fdde48f38e6d731e1574dcff.png
[70 3]: /images/20220518/4ee6617da5a3409ab24ddd72e2c5a838.png
[70 4]: /images/20220518/d01bb3b606a64318b387e8e0d2f3112f.png
[70 5]: /images/20220518/0e526f6fa8a243a29dfcd15d62d9ba7a.png
[70 6]: /images/20220518/fa6b9f248caa42de8e278db81fb599c3.png
[70 7]: /images/20220518/59b234fb5f7a457c90ed556438881720.png
[70 8]: /images/20220518/2cd61c79b2e74900b07e5e1e89e14812.png
[70 9]: /images/20220518/59e14af71615496ab1cef13de5a08732.png
[70 10]: /images/20220518/c36c66cc70914cb9ab22bb5569fbe046.png
[70 11]: /images/20220518/7215c877b4ed452081b30a52c5ccdcc9.png
[70 12]: /images/20220518/59773244ef8d43499b4a44d84a42c98a.png
[70 13]: /images/20220518/053ebf29ebda43a28901b379b9d8616c.png
[70 14]: /images/20220518/9626bdb4a0ee4493a49e1beb67c30bc8.png