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 |
| 被注解的元素必须是电子邮件格式 | |
| @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:不是一个合法的电子邮件地址