作用:用于对前端传进来的参数进行校验,省去了大量的逻辑判断
@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格式
注意一下这三个空检查的区别!!!!!!
-
@NotEmpty:用在集合类上面;不能为null,而且长度必须大于0 @NotBlank:
用在String上面;只能作用在String上,不能为null,而且调用trim()后,长度必须大于0
@NotNull:用在基本类型上;不能为null,但可以为empty。 总结: 1.注意注解引用的包不一样
2.@NotEmpty 用在集合类上面
@NotBlank 用在String上面
@NotNull 用在基本类型上 -
长度检查 @Size(min=,max=):验证对象(Array,Collection,Map,String)长度是否在给定的范围之内
不要错用了异常类型,比如在int上不可用@size @Length(min=, max=) : 只适用于String 类型Booelan检查 @AssertTrue: 验证 Boolean 对象是否为 true @AssertFalse: 验证 Boolean
对象是否为 false日期检查 @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指定小数精度。项目使用中遇到的问题:
一开始传入的参数没有使用@Validated 修饰,结果绑定不起作用,参数校验不成功,加上此注解即可生效。
所以BingdingResult是要与@Validated同时使用的。
控制台写法
@Valid RepairCard repairCard, BindingResult result
@PostMapping("/repair")
@ApiOperation("补卡操作")
public Result<Map<String, String>> repair(@ApiParam(name = "repairCard", value = "补卡记录", required = true) @Valid RepairCard repairCard, BindingResult result) {
if (result.hasErrors()) {
return Result.error(BindResultHandler.getMessages(result));
}