1. @Valid
功能:对接口方法的入参进行校验
@Data
public class User {
@NotNull( message = "ID不能为空" )
@Range( message = "ID范围为 {min} 到 {max} 之间" ,min = 0 ,max = 200 )
private Long id ;
@NotBlank( message = "姓名不能为空" )
@Length( message = "姓名不能超过{max}个字" ,max = 10 )
private String name;
}
Controller层,参数上添加@Valid注解,并传入BindingResult对象,用于获取校验失败情况下的反馈信息
@Controller
@RequestMapping( "/user" )
public class TestController {
@PostMapping( "/add" )
@ResponseBody
public R add( @Valid @RequestBody User user, BindingResult bindingResult) {
if( bindingResult.hasErrors( )) {
return R.error( ) .put( "data" , bindingResult.getAllErrors( ) .get( 0 ) .getDefaultMessage( )) ;
}
return R.ok( ) ;
}
}
不传入BindingResult对象,如果入参参数校验未通过,不会进入方法内,返回结果如下:
{
"timestamp" : "2022-06-19T10:06:11.218+00:00" ,
"status" : 400 ,
"error" : "Bad Request" ,
"path" : "/test"
}
@Null 限制只能为null
@NotNull 限制必须不为null
@AssertFalse 限制必须为false
@AssertTrue 限制必须为true
@DecimalMax( value) 限制必须为一个不大于指定值的数字
@DecimalMin( value) 限制必须为一个不小于指定值的数字
@Digits( integer,fraction) 限制必须为一个小数,且整数部分的位数不能超过integer,小数部分的位数不能超过fraction
@Future 限制必须是一个将来的日期
@Max( value) 限制必须为一个不大于指定值的数字
@Min( value) 限制必须为一个不小于指定值的数字
@Past 限制必须是一个过去的日期
@Pattern( value) 限制必须符合指定的正则表达式
@Size( max,min) 限制字符长度必须在min到max之间
@Past 验证注解的元素值(日期类型)比当前时间早
@NotEmpty 验证注解的元素值不为null且不为空(字符串长度不为0、集合大小不为0)
@NotBlank 验证注解的元素值不为空(不为null、去除首位空格后长度为0),不同于@NotEmpty,@NotBlank只应用于字符串且在比较时会去除字符串的空格
@Email 验证注解的元素值是Email,也可以通过正则表达式和flag指定自定义的email格式