为了提供可靠的API接口,对参数进行校验,保证数据入库的正确性,同事通过添加注释使用Validation规范避免写一大堆的if -else的校验语句。使代码更加简单清晰。
1、注解
1.1 空和非空校验
- @NotBlank:只能用于校验字符串不能为null,并且字符串
#trim()
以后 length 要大于 0 。 - @NotEmpty:集合对象的元素不为 0 ,即集合不为空,也可以用于字符串不为 null 。
- @NotNull:不能为 null 。
- @Null:必须为 null 。
1.2 数值校验
-
@DecimalMax(value)
:被注释的元素必须是一个数字,其值必须小于等于指定的最大值。 -
@DecimalMin(value)
:被注释的元素必须是一个数字,其值必须大于等于指定的最小值。 -
@Digits(integer, fraction)
:被注释的元素必须是一个数字,其值必须在可接受的范围内。 -
@Positive
:判断正数。 -
@PositiveOrZero
:判断正数或 0 。 -
@Max(value)
:该字段的值只能小于或等于该值。 -
@Min(value)
:该字段的值只能大于或等于该值。-@Negative
:判断负数。 -
@NegativeOrZero
:判断负数或 0 。
1.3 Boolean 值检查
-
@AssertFalse
:被注释的元素必须为 true 。 -
@AssertTrue
:被注释的元素必须为 false 。
1.4 长度检查
-
@Size(max, min)
:检查该字段的 size 是否在 min 和 max 之间,可以是字符串、数组、集合、Map 等。
1.5 日期检查
-
@Future
:被注释的元素必须是一个将