1 SpringMVC的数据绑定流程

  • SpringMVC将ServletRequest对象及目标方法的入参实例传递给WebDataBinderFactory实例，以创建DataBinder实例对象。
  • DataBinder调用装配在SpringMVC上下文中ConversionService组件进行数据类型转换、数据格式化工作。将Servlet中的请求信息填充到入参对象中。
  • 调用Validator组件对已经绑定了请求信息的入参对象进行数据合法性校验，并最终生成数据绑定结果BindingData对象。
  • SpringMVC抽取BindingResult中的入参对象和校验错误对象，将它们赋给处理方法的响应入参。
  • SpringMVC通过反射机制对目标处理方法进行解析，将请求消息绑定到处理方法的入参中。数据绑定的核心部件是DataBinder，运行机制如下：

2 数据转换

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

2.1 自定义类型转换器

  • ConversionService是Spring类型转换体系的核心接口。
  • 可以利用ConversionServiceFactoryBean在Spring的IOC容器中定义一个ConversionService。Spring将自动识别出IOC容器中的ConversionService，并在Bean属性配置及SpringMVC处理方法入参绑定等场合使用它进行数据的转换。
  • 可以通过ConversionServiceFactoryBean的converters属性注册自定义的类型转换器。
  • 示例：
  • index.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>

<html>

<head>

    <title>Title</title>

</head>

<body>

<a href="${pageContext.request.contextPath}/test?user=adc,123456,1">增加数据</a>

</body>

</html>
  • User.java
package com.sunxiaping.springmvc.domain;

import java.io.Serializable;

public class User implements Serializable {

    private String username;

    private String password;

    private Integer age;

    public String getUsername() {

        return username;

    }

    public void setUsername(String username) {

        this.username = username;

    }

    public String getPassword() {

        return password;

    }

    public void setPassword(String password) {

        this.password = password;

    }

    public Integer getAge() {

        return age;

    }

    public void setAge(Integer age) {

        this.age = age;

    }

}
  • UserConverter.java
package com.sunxiaping.springmvc.converters;

import com.sunxiaping.springmvc.domain.User;

import org.springframework.core.convert.converter.Converter;

public class UserConverter implements Converter<String, User> {

    @Override

    public User convert(String s) {

        if (null == s || s.length() == 0) {

            return null;

        }

        String[] split = s.split(",");

        User user = new User();

        user.setUsername(split[0]);

        user.setPassword(split[1]);

        user.setAge(Integer.parseInt(split[2]));

        return user;

    }

}
  • UserController.java
package com.sunxiaping.springmvc.controller;

import com.sunxiaping.springmvc.domain.User;

import org.springframework.stereotype.Controller;

import org.springframework.web.bind.annotation.RequestMapping;

@Controller

public class UserController {

    @RequestMapping(value = "/test")

    public String test(User user){

        System.out.println(user);

        return "success";

    }

}
  • SpringMVC.xml
<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans"

       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

       xmlns:mvc="http://www.springframework.org/schema/mvc"

       xmlns:context="http://www.springframework.org/schema/context"

       xmlns:aop="http://www.springframework.org/schema/aop"

       xmlns:tx="http://www.springframework.org/schema/tx"

       xsi:schemaLocation="http://www.springframework.org/schema/beans

        http://www.springframework.org/schema/beans/spring-beans-4.0.xsd

        http://www.springframework.org/schema/mvc

        http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd

        http://www.springframework.org/schema/context

        http://www.springframework.org/schema/context/spring-context-4.0.xsd

        http://www.springframework.org/schema/aop

        http://www.springframework.org/schema/aop/spring-aop-4.0.xsd

        http://www.springframework.org/schema/tx

        http://www.springframework.org/schema/tx/spring-tx-4.0.xsd ">

    <!-- 配置自动扫描的包 -->

    <context:component-scan base-package="com.sunxiaping.springmvc"></context:component-scan>

    <!-- 配置视图解析器 -->

    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">

        <property name="prefix" value="/WEB-INF/views/"></property>

        <property name="suffix" value=".jsp"></property>

    </bean>

    <bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">

        <property name="converters">

            <set>

                <bean class="com.sunxiaping.springmvc.converters.UserConverter"></bean>

            </set>

        </property>

    </bean>

    <mvc:annotation-driven conversion-service="conversionService"></mvc:annotation-driven>

</beans>
  • success.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>

<html>

<head>

    <title>Title</title>

</head>

<body>

成功啦 <br/>

</body>

</html>

2.2 关于<mvc:annotation-drivern>

  • <mvc:annotation-drivern>会自动注册RequestMappingHandlerMapping、RequestMappingHandlerAdapter和ExceptionHandlerExceptionResolver三个Bean。
  • 还将提供以下的支持：
    • 支持使用ConversionService实例对表单参数进行转换。
    • 支持使用@NumberFormat注解和@DateTimeFormat注解完成数据格式化。
    • 支持使用@Valid注解对JavaBean实例进行JSR303验证。
    • 支持使用@RequestBody和@Res婆娘色Body注解。　

2.3 @InitBinder注解

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

public void initBinder(WebDataBinder webDataBinder){

    webDataBinder.setDisallowedFields("roleIds");

}

3 数据格式化

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

3.1 日期格式化

  • @DateTimeFormat注解可以为java.util.Date、java.util.Calendar、java.lang.Long时间类型进行标注。
package org.springframework.format.annotation;

import java.lang.annotation.Documented;

import java.lang.annotation.ElementType;

import java.lang.annotation.Retention;

import java.lang.annotation.RetentionPolicy;

import java.lang.annotation.Target;

@Documented

@Retention(RetentionPolicy.RUNTIME)

@Target({ElementType.METHOD, ElementType.FIELD, ElementType.PARAMETER, ElementType.ANNOTATION_TYPE})

public @interface DateTimeFormat {

    String style() default "SS";

    ISO iso() default ISO.NONE;

    String pattern() default "";

    enum ISO {

        /**

         * The most common ISO Date Format {@code yyyy-MM-dd},

         * e.g. "2000-10-31".

         */

        DATE,

        /**

         * The most common ISO Time Format {@code HH:mm:ss.SSSXXX},

         * e.g. "01:30:00.000-05:00".

         */

        TIME,

        /**

         * The most common ISO DateTime Format {@code yyyy-MM-dd'T'HH:mm:ss.SSSXXX},

         * e.g. "2000-10-31T01:30:00.000-05:00".

         * <p>This is the default if no annotation value is specified.

         */

        DATE_TIME,

        /**

         * Indicates that no ISO-based format pattern should be applied.

         */

        NONE

    }

}
  • 其中：

    • pattern属性：指定解析/格式化字段数据的模式，如"yyyy-MM-dd HH:mm:ss"。
    • 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属性：字符串类型。通过样式指定日期时间的格式。　　

3.2 数值格式化

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

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

3.3 应用示例

  • 示例：
  • index.jsp　　
<%@ page contentType="text/html;charset=UTF-8" language="java" %>

<html>

<head>

    <title>Title</title>

</head>

<body>

<a href="${pageContext.request.contextPath}/test?username=adc&salary=13,500&birthday=2018-09-21">增加数据</a>

</body>

</html>
  • User.java
package com.sunxiaping.springmvc.domain;

import org.springframework.format.annotation.DateTimeFormat;

import org.springframework.format.annotation.NumberFormat;

import java.io.Serializable;

import java.util.Date;

public class User implements Serializable {

    private String username;

    @DateTimeFormat(pattern = "yyyy-MM-dd")

    private Date birthday;

    @NumberFormat(pattern = "##,###")

    private Double salary;

    public Double getSalary() {

        return salary;

    }

    public void setSalary(Double salary) {

        this.salary = salary;

    }

    public String getUsername() {

        return username;

    }

    public void setUsername(String username) {

        this.username = username;

    }

    public Date getBirthday() {

        return birthday;

    }

    public void setBirthday(Date birthday) {

        this.birthday = birthday;

    }

    @Override

    public String toString() {

        return "User{" +

                "username='" + username + '\'' +

                ", birthday=" + birthday +

                ", salary=" + salary +

                '}';

    }

}
  • UserController.java
package com.sunxiaping.springmvc.controller;

import com.sunxiaping.springmvc.domain.User;

import org.springframework.stereotype.Controller;

import org.springframework.web.bind.annotation.RequestMapping;

@Controller

public class UserController {

    @RequestMapping(value = "/test")

    public String test(User user){

        System.out.println(user);

        return "success";

    }

}
  • success.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>

<html>

<head>

    <title>Title</title>

</head>

<body>

成功啦 <br/>

</body>

</html>
  • SpringMVC.xml
<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans"

       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

       xmlns:mvc="http://www.springframework.org/schema/mvc"

       xmlns:context="http://www.springframework.org/schema/context"

       xmlns:aop="http://www.springframework.org/schema/aop"

       xmlns:tx="http://www.springframework.org/schema/tx"

       xsi:schemaLocation="http://www.springframework.org/schema/beans

        http://www.springframework.org/schema/beans/spring-beans-4.0.xsd

        http://www.springframework.org/schema/mvc

        http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd

        http://www.springframework.org/schema/context

        http://www.springframework.org/schema/context/spring-context-4.0.xsd

        http://www.springframework.org/schema/aop

        http://www.springframework.org/schema/aop/spring-aop-4.0.xsd

        http://www.springframework.org/schema/tx

        http://www.springframework.org/schema/tx/spring-tx-4.0.xsd ">

    <!-- 配置自动扫描的包 -->

    <context:component-scan base-package="com.sunxiaping.springmvc"></context:component-scan>

    <!-- 配置视图解析器 -->

    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">

        <property name="prefix" value="/WEB-INF/views/"></property>

        <property name="suffix" value=".jsp"></property>

    </bean>

    <mvc:annotation-driven ></mvc:annotation-driven>

</beans>

4 数据校验

4.1 概述

  • JSR303是java为Bean数据合法性校验提供的标准框架、
  • JSR303通过在Bean属性上标注类似于@NotNull、@Max等标准的注解指定校验规则，并通过标准的验证接口对Bean进行校验。
  • 常用的注解：
  • @Null：被标注的元素必须为null。
  • @NotNull：被标注的元素必须不为null。
  • @AssertTrue：被标注的元素必须为true。
  • @AssertFalse：被标注的元素必须为false。
  • @Min(value)：被标注的元素必须是一个数字，其值必须>=指定的最小值。
  • @Max(value)：被标注的元素必须是一个数字，其值必须<=指定的最大值。
  • @DecimalMin(value)：被标注的元素必须是一个数字，其值必须>=指定的最小值。
  • @DecimalMax(value)：被标注的元素必须是一个数字，其值必须<=指定的最大值。
  • @Size(max,min)：被标注的元素的大小必须在指定的范围内。
  • @Digits(integer,fraction)：被标注的元素必须是一个数字，其值必须在可接受的范围内。
  • @Past：被标注的元素必须是一个过去的日期。
  • @Future：被标注的元素必须是一个将来的日期。
  • @Pattern：被标注的元素必须符合指定的正则表达式。

4.2 Hibernate Validator扩展注解

  • Hibernate Validator时JSR303的一个参考实现，除支持所有标准的校验注解外，它还支持以下的扩展注解：
  • @Email：被标注的元素必须是电子邮箱地址。
  • @Length：被标注的字符串的大小必须在指定的范围内。
  • @NotEmpty：被标准的字符串必须非空。
  • @Range：被标准的元素必须在合适的范围内。

4.3 SpringMVC的数据校验

  • Spring拥有自己独立的数据校验框架，同时支持JSR303标准的校验框架。
  • Spring在进行数据绑定的时候，可以同时调用校验框架完成数据校验工作。在SpringMVC中，可直接通过注解驱动的方式进行数据校验。
  • Spring的LocalValidatorFactoryBean既实现了Spring的Validator接口，也实现了JSR303的Validator接口，只要在Spring容器中定义一个LocalValidatorFactoryBean，就可以将其注入到需要数据校验的Bean中。
  • Spring本身并没有提供JSR303的实现，所以必须导入JSR303的实现。
  • <mvc:annotation-drivern/>会默认装配一个LocalValidatorFactoryBean，通过在处理方法的入参上标注@Valid注解，即可让SpringMVC在完成数据绑定后执行数据校验的工作。
  • 在已经标准了JSR303注解的表单对象前标注一个@Valid，SpringMVC框架在将请求参数绑定到该入参对象后，就会调用校验框架根据注解声明的校验规则实施校验。
  • SpringMVC是通过对处理方法签名的规则来保存校验结果的：前一个表单对象的校验结果保存到随后的入参中，这个保存校验结果的入参必须是BindingResult或Errors类型，这两个接口都位于org.springframework.validation包中，其中BindingResult继承了Errors接口。
  • BindingResult的常用方法：
  • 获取所有的FieldError集合：
List<FieldError> getFieldErrors();
  • 返回error的错误个数：
int getErrorCount();
  • 根据属性名获取FieldError对象：
FieldError getFieldError(String field);
  • 根据属性名获取错误信息：
Object getFieldValue(String field);
  • 示例：
  • 导入hibernate validator坐标：
<dependency>

    <groupId>org.hibernate</groupId>

    <artifactId>hibernate-validator</artifactId>

    <version>5.0.2.Final</version>

</dependency>
  • index.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>

<html>

<head>

    <title>Title</title>

</head>

<body>

<form action="${pageContext.request.contextPath}/test" method="post">

    用户名:<input type="text" name="username"/><br/>

    出生日期:<input type="text" name="brithday"/><br/>

    <input type="submit" value="提交">

</form>

</body>

</html>
  • User.java
package com.sunxiaping.springmvc.domain;

import org.hibernate.validator.constraints.NotEmpty;

import org.springframework.format.annotation.DateTimeFormat;

import javax.validation.constraints.NotNull;

import javax.validation.constraints.Past;

import java.io.Serializable;

import java.util.Date;

public class User implements Serializable {

    @NotEmpty(message = "用户名不能为空")

    private String username;

    @DateTimeFormat(pattern = "yyyy-MM-dd")

    @NotNull(message = "出生日期不能为空")

    @Past(message = "必须比当前日期小")

    private Date birthday;

    public String getUsername() {

        return username;

    }

    public void setUsername(String username) {

        this.username = username;

    }

    public Date getBirthday() {

        return birthday;

    }

    public void setBirthday(Date birthday) {

        this.birthday = birthday;

    }

}
  • UserController.java
package com.sunxiaping.springmvc.controller;

import com.sunxiaping.springmvc.domain.User;

import org.springframework.stereotype.Controller;

import org.springframework.validation.BindingResult;

import org.springframework.validation.FieldError;

import org.springframework.web.bind.annotation.RequestMapping;

import javax.validation.Valid;

import java.util.List;

@Controller

public class UserController {

    @RequestMapping(value = "/test")

    public String test(@Valid User user, BindingResult result) {

        System.out.println(user);

        int errorCount = result.getErrorCount();

        System.out.println("获取错误的个数:" + errorCount);

        List<FieldError> fieldErrors = result.getFieldErrors();

        for (FieldError fieldError : fieldErrors) {

            String field = fieldError.getField();

            String defaultMessage = fieldError.getDefaultMessage();

            System.out.println("属性名:" + field + ",错误消息：" + defaultMessage);

        }

        return "success";

    }

}
  • SpringMVC.xml
<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans"

       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

       xmlns:mvc="http://www.springframework.org/schema/mvc"

       xmlns:context="http://www.springframework.org/schema/context"

       xmlns:aop="http://www.springframework.org/schema/aop"

       xmlns:tx="http://www.springframework.org/schema/tx"

       xsi:schemaLocation="http://www.springframework.org/schema/beans

        http://www.springframework.org/schema/beans/spring-beans-4.0.xsd

        http://www.springframework.org/schema/mvc

        http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd

        http://www.springframework.org/schema/context

        http://www.springframework.org/schema/context/spring-context-4.0.xsd

        http://www.springframework.org/schema/aop

        http://www.springframework.org/schema/aop/spring-aop-4.0.xsd

        http://www.springframework.org/schema/tx

        http://www.springframework.org/schema/tx/spring-tx-4.0.xsd ">

    <!-- 配置自动扫描的包 -->

    <context:component-scan base-package="com.sunxiaping.springmvc"></context:component-scan>

    <!-- 配置视图解析器 -->

    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">

        <property name="prefix" value="/WEB-INF/views/"></property>

        <property name="suffix" value=".jsp"></property>

    </bean>

    <mvc:annotation-driven></mvc:annotation-driven>

</beans>
  • success.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>

<html>

<head>

    <title>Title</title>

</head>

<body>

成功啦 <br/>

</body>

</html>

最新文章

  1. xhtml文档
  2. HDU 1106 排序 题解
  3. Kali Linux Web 渗透测试视频教程— 第十六课-拒绝服务攻击
  4. Postfix之telnet测试
  5. 二维图形的矩阵变换（三）——在WPF中的应用矩阵变换
  6. Java IO6 ：IO总结
  7. javascript 数据结构和算法读书笔记 &gt; 第二章 数组
  8. windows10 conda python多版本切换
  9. Angular2 ng2-smart-table
  10. JavaScript优化细节（一）
  11. 二叉树建立及遍历 C++ 源码
  12. vue基本语法
  13. python自动化测试入门篇-jemter连接mysql数据库
  14. 2.3 xpath定位
  15. PAT 乙级 1020 月饼 (25) C++版
  16. 流媒体技术学习笔记之（八）海康、大华IpCamera RTSP地址和格式
  17. 【006】【JVM——垃圾收集器总结】
  18. JAVA EE 项目常用知识 之AJAX技术实现select下拉列表联动的两种用法（让你真正理解ajax）
  19. vue 给嵌套的iframe子页面传数据 postMessage
  20. Java规则引擎drools：drt动态生成规则并附上具体项目逻辑

热门文章

  1. SparseLDA算法
  2. CentOS 7 Docker 安装
  3. getApplication()和getApplicationContext()区别
  4. java 接口default的判断规则
  5. python学习之不要在列表迭代的时候进行增删操作
  6. php配置 php-cgi.sock使用
  7. mysql默认的存储引擎是什么？它们的区别有哪些？mysql中索引有哪些？
  8. python2.X与3.X比较及Python编译器选择
  9. 【AI-人工智能-mmdetection】ModuleNotFoundError: No module named &#39;mmdet.version&#39;
  10. python每日一练：0002题