SpringMVC--使用hibernate validator数据校验

JSR 303

Spring3开始支持JSR 303 验证框架，JSR303是Java为Bean数据合法性校验所提供的标准框架。JSR 303 支持XML和注解风格的验证，通过在Bean属性上标注类似于@NotNull等的标准注解指定校验规则，并通过标准的验证接口对Bean进行验证。

JSR 303注解约束

约束	说明
@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(value)	被注解的元素必须符合指定的正则表达式

Hibernate Validator扩展的注解

约束	说明
@NotBlank	检查被注解的元素是不是Null，以及被去掉前后空格的长度是否大于0
@Email	被注解的元素必须是电子邮件格式
@URL	被注解的元素必须是合法的URL地址
@length	被注解的字符串的大小必须在指定的范围内
@NotEmpty	检查被注解的字符串必须非空
@Range	被注解的元素必须在合适的范围内

实例

引入依赖

pom.xml

<dependency>
      <groupId>javax.validation</groupId>
      <artifactId>validation-api</artifactId>
      <version>2.0.1.Final</version>
    </dependency>
    <dependency>
      <groupId>org.hibernate</groupId>
      <artifactId>hibernate-validator</artifactId>
      <version>5.0.1.Final</version><!-- tomcat7不支持6.0以上,el包冲突，引入el也无法解析 -->
    </dependency>
           

创建实体类

package pers.zhang.entity;

import org.hibernate.validator.constraints.Email;
import org.hibernate.validator.constraints.NotEmpty;
import org.hibernate.validator.constraints.Range;

import javax.validation.constraints.Size;

/**
 * @author zhang
 * @date 2019/11/27 - 9:55
 */
public class Person {

    @NotEmpty
    @Size(min = 6, max = 20)
    private String name;

    @Range(min = 18, max = 45)
    private int age;

    @Email
    @NotEmpty
    private String email;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }
}
           

Controller

package pers.zhang.cotroller;

import org.springframework.stereotype.Controller;
import org.springframework.validation.BindingResult;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.annotation.RequestMapping;
import pers.zhang.entity.Person;

import javax.validation.Valid;

/**
 * @author zhang
 * @date 2019/11/27 - 9:56
 */
@Controller
public class PersonController {

	/*
	  @Valid注解告诉SpringMVC，Person类的对象person在绑定表单数据后需要进行JSR 303
	  验证，绑定的结果保存到BindingResult类型的对象result中，通过判断result就可以知道
	  绑定过程是否出现错误，如果出现错误则输出。
	*/
    @RequestMapping("/testValidate")
    public String testValidate(@Valid Person person, BindingResult result){
        if(result.getErrorCount() > 0){
            for(FieldError error : result.getFieldErrors()){
                System.out.println(error.getField() + ":" + error.getDefaultMessage());
            }
        }
        return  "success";
    }
}
           

表单

<form action="testValidate" method="post">
        姓名：<input type="text" name="name"><br>
        年龄：<input type="text" name="age"><br>
        邮箱：<input type="text" name="email"><br>
        <input type="submit" value="提交">
    </form>
           

测试

name:不能为空
age:需要在18和45之间
name:个数必须在6和20之间
email:不是一个合法的电子邮件地址