SpringMVC表单校验

表单校验的重要性

表单校验保障了数据有效性、安全性

数据可以随意输入，导致错误的结果。后端表单校验的重要性

表单校验分类

• 校验位置：
  • 客户端校验
  • 服务端校验
• 校验内容与对应方式：
  • 格式校验
    • 客户端：使用Js技术，利用正则表达式校验
    • 服务端：使用校验框架
  • 逻辑校验
    • 客户端：使用ajax发送要校验的数据，在服务端完成逻辑校验，返回校验结果
    • 服务端：接收到完整的请求后，在执行业务操作前，完成逻辑校验

表单校验规则

• 长度：例如用户名长度，评论字符数量
• 非法字符：例如用户名组成
• 数据格式：例如Email格式、 IP地址格式
• 边界值：例如转账金额上限，年龄上下限
• 重复性：例如用户名是否重复

表单校验框架

• JSR（Java Specification Requests）：Java 规范提案

  303：提供bean属性相关校验规则

• JSR规范列表

  • 企业应用技术
     Contexts and Dependency Injection for Java (Web Beans 1.0) (JSR 299)
     Dependency Injection for Java 1.0 (JSR 330)@postConstruct, @PreDestroy
     Bean Validation 1.0 (JSR 303)
     Enterprise JavaBeans 3.1 (includes Interceptors 1.1) (JSR 318)
     Java EE Connector Architecture 1.6 (JSR 322)
     Java Persistence 2.0 (JSR 317)
     Common Annotations for the Java Platform 1.1 (JSR 250)
     Java Message Service API 1.1 (JSR 914)
     Java Transaction API (JTA) 1.1 (JSR 907)
     JavaMail 1.4 (JSR 919)
  • Web应用技术
     Java Servlet 3.0 (JSR 315)
     JavaServer Faces 2.0 (JSR 314)
     JavaServer Pages 2.2/Expression Language 2.2 (JSR 245)
     Standard Tag Library for JavaServer Pages (JSTL) 1.2 (JSR 52)
     Debugging Support for Other Languages 1.0 (JSR 45)
     模块化 (JSR 294)
     Swing应用框架 (JSR 296)
     JavaBeans Activation Framework (JAF) 1.1 (JSR 925)
     Streaming API for XML (StAX) 1.0 (JSR 173)
  • 管理与安全技术
     Java Authentication Service Provider Interface for Containers (JSR 196)
     Java Authorization Contract for Containers 1.3 (JSR 115)
     Java EE Application Deployment 1.2 (JSR 88)
     J2EE Management 1.1 (JSR 77)
     Java SE中与Java EE有关的规范
     JCache API (JSR 107)
     Java Memory Model (JSR 133)
     Concurrency Utilitie (JSR 166)
     Java API for XML Processing (JAXP) 1.3 (JSR 206)
     Java Database Connectivity 4.0 (JSR 221)
     Java Management Extensions (JMX) 2.0 (JSR 255)
     Java Portlet API (JSR 286)

• Web Service技术
   Java Date与Time API (JSR 310)
   Java API for RESTful Web Services (JAX-RS) 1.1 (JSR 311)
   Implementing Enterprise Web Services 1.3 (JSR 109)
   Java API for XML-Based Web Services (JAX-WS) 2.2 (JSR 224)
   Java Architecture for XML Binding (JAXB) 2.2 (JSR 222)
   Web Services Metadata for the Java Platform (JSR 181)
   Java API for XML-Based RPC (JAX-RPC) 1.1 (JSR 101)
   Java APIs for XML Messaging 1.3 (JSR 67)
   Java API for XML Registries (JAXR) 1.0 (JSR 93)

• JCP（Java Community Process）：Java社区

• Hibernate框架中包含一套独立的校验框架hibernate-validator
  导入坐标

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>6.1.0.Final</version>
</dependency>

注意：
tomcat7 ：搭配hibernate-validator版本5...Final
tomcat8.5↑ ：搭配hibernate-validator版本6...Final

快速使用

1. 开启校验

 名称：@Valid 、 @Validated
 类型：形参注解
 位置：处理器类中的实体类类型的方法形参前方
 作用：设定对当前实体类类型参数进行校验
 范例：

@RequestMapping(value = "/addemployee")
public String addEmployee(@Valid Employee employee) {
    System.out.println(employee);
}

2.设置校验规则

 名称：@NotNull
 类型：属性注解 等
 位置：实体类属性上方
 作用：设定当前属性校验规则
 范例：
每个校验规则所携带的参数不同，根据校验规则进行相应的调整
具体的校验规则查看对应的校验框架进行获取

public class Employee{
 @NotNull(message = "姓名不能为空")
 private String name;//员工姓名
}  

3.获取错误信息

@RequestMapping(value = "/addemployee")
public String addEmployee(@Valid Employee employee, Errors errors, Model model){
    System.out.println(employee);
    if(errors.hasErrors()){
        for(FieldError error : errors.getFieldErrors()){
            model.addAttribute(error.getField(),error.getDefaultMessage());
        }
        return "addemployee.jsp";
    }
    return "success.jsp";
}  

通过形参Errors获取校验结果数据，通过Model接口将数据封装后传递到页面显示

<form action="/addemployee" method="post">
    员工姓名：<input type="text" name="name"><span style="color:red">${name}</span><br/>
    员工年龄：<input type="text" name="age"><span style="color:red">${age}</span><br/>
    <input type="submit" value="提交">
</form>

通过形参Errors获取校验结果数据，通过Model接口将数据封装后传递到页面显示
页面获取后台封装的校验结果信息

多规则校验

• 同一个属性可以添加多个校验器

@NotNull(message = "请输入您的年龄")
@Max(value = 60,message = "年龄最大值不允许超过60岁")
@Min(value = 18,message = "年龄最小值不允许低于18岁")
private Integer age;//员工年龄

• 3种判定空校验器的区别
  

嵌套校验

 名称：@Valid
 类型：属性注解
 位置：实体类中的引用类型属性上方
 作用：设定当前应用类型属性中的属性开启校验
 范例：

public class Employee {
    //实体类中的引用类型通过标注@Valid注解，设定开启当前引用类型字段中的属性参与校验
    @Valid
    private Address address;
}

 注意：开启嵌套校验后，被校验对象内部需要添加对应的校验规则

分组校验

• 同一个模块，根据执行的业务不同，需要校验的属性会有不同
  • 新增用户
  • 修改用户
• 对不同种类的属性进行分组，在校验时可以指定参与校验的字段所属的组类别
  • 定义组（通用）
  • 为属性设置所属组，可以设置多个
  • 开启组校验

public interface GroupOne {
}

public String addEmployee(@Validated({GroupOne.class}) Employee employee){
}  

@NotEmpty(message = "姓名不能为空",groups = {GroupOne.class})
private String name;//员工姓名