JSR303定义的校验类型
空检查
@Null 验证对象是否为null
@NotNull 验证对象是否不为null, 无法查检长度为0的字符串
@NotBlank 检查约束字符串是不是Null还有被Trim的长度是否大于0,只对字符串,且会去掉前后空格.
@NotEmpty 检查约束元素是否为NULL或者是EMPTY.
Booelan检查
@AssertTrue 验证 Boolean 对象是否为 true
@AssertFalse 验证 Boolean 对象是否为 false
长度检查
@Size(min=, max=) 验证对象（Array,Collection,Map,String）长度是否在给定的范围之内
@Length(min=, max=) 验证注解的元素值长度在min和max区间内
日期检查
@Past 验证 Date 和 Calendar 对象是否在当前时间之前
@Future 验证 Date 和 Calendar 对象是否在当前时间之后
@Pattern 验证 String 对象是否符合正则表达式的规则
数值检查，建议使用在Stirng,Integer类型，不建议使用在int类型上，因为表单值为“”时无法转换为int，但可以转换为Stirng为"",Integer为null
@Min 验证 Number 和 String 对象是否大等于指定的值
@Max 验证 Number 和 String 对象是否小等于指定的值
@DecimalMax 被标注的值必须不大于约束中指定的最大值. 这个约束的参数是一个通过BigDecimal定义的最大值的字符串表示.小数存在精度
@DecimalMin 被标注的值必须不小于约束中指定的最小值. 这个约束的参数是一个通过BigDecimal定义的最小值的字符串表示.小数存在精度
@Digits 验证 Number 和 String 的构成是否合法
@Digits(integer=,fraction=) 验证字符串是否是符合指定格式的数字，interger指定整数精度，fraction指定小数精度。
@Range(min=, max=) 验证注解的元素值在最小值和最大值之间
@Range(min=10000,max=50000,message="range.bean.wage")
private BigDecimal wage;
@Valid 递归的对关联对象进行校验, 如果关联对象是个集合或者数组,那么对其中的元素进行递归校验,如果是一个map,则对其中的值部分进行校验.(是否进行递归验证)
@CreditCardNumber信用卡验证
@Email 验证是否是邮件地址，如果为null,不进行验证，算通过验证。
@ScriptAssert(lang= ,script=, alias=)
@URL(protocol=,host=, port=,regexp=, flags=)
概述：
@Valid是使用Hibernate validation的时候使用
@Validated是只用Spring Validator校验机制使用
说明：java的JSR303声明了@Valid这类接口，而Hibernate-validator对其进行了实现
@Validation对@Valid进行了二次封装，在使用上并没有区别，但在分组、注解位置、嵌套验证等功能上有所不同，这里主要就这几种情况进行说明。
注解位置：
@Validated：用在类型、方法和方法参数上。但不能用于成员属性（field）
@Valid：可以用在方法、构造函数、方法参数和成员属性（field）上
如：
==================》》》》 
如果@Validated注解在成员属性上，则会报 不适用于field错误
分组校验：
@Validated：提供分组功能，可以在参数验证时，根据不同的分组采用不同的验证机制
@Valid：没有分组功能
举例：
定义分组接口：
-
public
interface IGroupA {
-
}
-
-
public
interface IGroupB {
-
}
定义需要检验的参数bean：
-
public
class StudentBean implements Serializable{
-
@NotBlank(message = "用户名不能为空")
-
private String name;
-
//只在分组为IGroupB的情况下进行验证
-
@Min(value = 18, message = "年龄不能小于18岁", groups = {IGroupB.class})
-
private Integer age;
-
@Pattern(regexp = "^((13[0-9])|(14[5,7,9])|(15([0-3]|[5-9]))|(166)|(17[0,1,3,5,6,7,8])|(18[0-9])|(19[8|9]))\\d{8}$", message = "手机号格式错误")
-
private String phoneNum;
-
@Email(message = "邮箱格式错误")
-
private String email;
-
@MyConstraint
-
private String className;
测试代码：
检验分组为IGroupA的情况
-
@RestController
-
public
class CheckController {
-
@PostMapping("stu")
-
public String addStu(
@Validated({IGroupA.class})
@RequestBody StudentBean studentBean){
-
return
"add student success";
-
}
-
}
测试：
这里对分组IGroupB的就没检验了
如果把测试代码改成下面这样，看看测试结果
-
@RestController
-
public
class CheckController {
-
@PostMapping("stu")
-
public String addStu(
@Validated({IGroupA.class, IGroupB.class})
@RequestBody StudentBean studentBean){
-
return
"add student success";
-
}
-
}
说明：
1、不分 配groups，默认每次都要进行验证
2、对一个参数需要多种验证方式时，也可通过分配不同的组达到目的。
组序列：
默认情况下 不同级别的约束验证是无序的，但是在一些情况下，顺序验证却是很重要。
一个组可以定义为其他组的序列，使用它进行验证的时候必须符合该序列规定的顺序。在使用组序列验证的时候，如果序列前边的组验证失败，则后面的组将不再给予验证。
举例：
定义组序列：
-
@GroupSequence({Default.
class, IGroupA.
class, IGroupB.
class})
-
public
interface IGroup {
-
}
需要校验的Bean，分别定义IGroupA对age进行校验，IGroupB对className进行校验：
-
public
class StudentBean implements Serializable{
-
@NotBlank(message = "用户名不能为空")
-
private String name;
-
@Min(value = 18, message = "年龄不能小于18岁", groups = IGroupA.class)
-
private Integer age;
-
@Pattern(regexp = "^((13[0-9])|(14[5,7,9])|(15([0-3]|[5-9]))|(166)|(17[0,1,3,5,6,7,8])|(18[0-9])|(19[8|9]))\\d{
8}$", message = "手机号格式错误")
-
private String phoneNum;
-
@Email(message = "邮箱格式错误")
-
private String email;
-
@MyConstraint(groups = IGroupB.class)
-
private String className;
测试代码：
-
@RestController
-
public
class CheckController {
-
@PostMapping("stu")
-
public String addStu(
@Validated({IGroup.class})
@RequestBody StudentBean studentBean){
-
return
"add student success";
-
}
-
}
测试发现，如果age出错，那么对组序列在IGroupA后的IGroupB不进行校验，即例子中的className不进行校验，结果如下：
嵌套校验：
一个待验证的pojo类，其中还包含了待验证的对象，需要在待验证对象上注解@Valid，才能验证待验证对象中的成员属性，这里不能使用@Validated。
举例：
需要约束校验的bean：
-
public
class TeacherBean {
-
@NotEmpty(message = "老师姓名不能为空")
-
private String teacherName;
-
@Min(value = 1, message = "学科类型从1开始计算")
-
private int type;
-
public
class StudentBean implements Serializable{
-
@NotBlank(message = "用户名不能为空")
-
private String name;
-
@Min(value = 18, message = "年龄不能小于18岁")
-
private Integer age;
-
@Pattern(regexp = "^((13[0-9])|(14[5,7,9])|(15([0-3]|[5-9]))|(166)|(17[0,1,3,5,6,7,8])|(18[0-9])|(19[8|9]))\\d{
8}$", message = "手机号格式错误")
-
private String phoneNum;
-
@Email(message = "邮箱格式错误")
-
private String email;
-
@MyConstraint
-
private String className;
-
-
@NotNull(message = "任课老师不能为空")
-
@Size(min = 1, message = "至少有一个老师")
-
private List<TeacherBean> teacherBeans;
注意：
这里对teacherBeans只校验了NotNull, 和 Size，并没有对teacher信息里面的字段进行校验，具体测试如下：
这里teacher中的type明显是不符合约束要求的，但是能检测通过，是因为在student中并没有做 嵌套校验
可以在teacherBeans中加上
@Valid，具体如下：
-
@Valid
-
@NotNull(message =
"任课老师不能为空")
-
@Size(min =
1, message =
"至少有一个老师")
-
private List<TeacherBean> teacherBeans;
这里再来测试，会发现如下结果：
1万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
