当前位置 博文首页 > CHQIUU的专栏:Spring Boot Validator校验注解配置说明

    CHQIUU的专栏:Spring Boot Validator校验注解配置说明

    作者:[db:作者] 时间:2021-07-20 21:57

    Spring Boot Validator校验注解配置说明

    验证注解验证的数据类型说明
    空检查
    @Null任意类型验证注解的元素值是null
    @NotNull任意类型验证注解的元素不是null
    @NotBlankCharSequence子类型(CharBuffer、String、StringBuffer、StringBuilder)验证注解的元素值不为空(不为null、去除首尾空格后长度不为0),不同于@NotEmpty,@NotBlank只应用于字符串且在比较时会去除字符串的首尾空格
    @NotEmptyCharSequence子类型、Collection、Map、数组验证注解的元素值不为null且不为空(字符串长度不为0、集合大小不为0)
    Boolean检查
    @AssertFalseBoolean,boolean验证注解的元素值是false
    @AssertTrueBoolean,boolean验证注解的元素值是true
    长度检查
    @Size(min=下限, max=上限)字符串、Collection、Map、数组等验证注解的元素值的在min和max(包含)指定区间之内,如字符长度、集合大小
    @Length(min=下限, max=上限)CharSequence子类型验证注解的元素值长度在min和max区间内
    日期检查
    @Pastjava.util.Date,java.util.Calendar;Joda Time类库的日期类型验证注解的元素值(日期类型)比当前时间早
    @Future与@Past要求一样验证注解的元素值(日期类型)比当前时间晚
    数值检查
    @MIN(value=值)BigDecimal,BigInteger, byte,short, int, long,等任何Number或CharSequence(存储的是数字)子类型验证注解的元素值大于等于@Min指定的value值
    @MAX(value=值)和@Min要求一样验证注解的元素值小于等于@Max指定的value值
    @DecimalMin(value=值)和@Min要求一样验证注解的元素值大于等于@ DecimalMin指定的value值
    @DecimalMax(value=值)和@Min要求一样验证注解的元素值小于等于@ DecimalMax指定的value值
    @Digits(integer=整数位数, fraction=小数位数)和@Min要求一样验证注解的元素值的整数位数和小数位数上限
    @Range(min=最小值, max=最大值)BigDecimal,BigInteger,CharSequence, byte, short, int, long等原子类型和包装类型验证注解的元素值在最小值和最大值之间
    其他检查
    @Valid任何非原子类型指定递归验证关联的对象;如用户对象中有个地址对象属性,如果想在验证用户对象时一起验证地址对象的话,在地址对象上加@Valid注解即可级联验证
    @Pattern(regexp=正则表达式,flag=标志的模式)CharSequence的子类型验证注解的元素值与指定的正则表达式匹配
    @Email(regexp=正则表达式,flag=标志的模式)CharSequence的子类型验证注解的元素值是Email,也可以通过regexp和flag指定自定义的email格式
    @CreditCardNumberCharSequence的子类型验证注解元素值是信用卡卡号
    @ScriptAssert(lang= ,script=)业务类校验复杂的业务逻辑
    自定义检查
    @JsonFormatCharSequence的子类型JSON格式数据校验
    @TimeInterval业务类时间先后校验,开始时间不能在结束时间之后
    @MobileNumberCharSequence的子类型手机号码格式校验

    实际例子:

    @Size(min=3, max=20, message="用户名长度只能在3-20之间")
    @Size(min=6, max=20, message="密码长度只能在6-20之间")
    @Pattern (regexp="[a-za-z0-9._%+-]+@[a-za-z0-9.-]+\\.[a-za-z]{2,4}", message="邮件格式错误")
    @Length(min = 5, max = 20, message = "用户名长度必须位于5到20之间")  
    @Email(message = "比如输入正确的邮箱")  
    @NotNull(message = "用户名称不能为空") 
    @Max(value = 100, message = "年龄不能大于100岁") 
    @Min(value= 18 ,message= "必须年满18岁!" )  
    @AssertTrue(message = "bln4 must is true")
    @AssertFalse(message = "blnf must is falase")
    @DecimalMax(value="100",message="decim最大值是100")
    @DecimalMin(value="100",message="decim最小值是100")
    @NotNull(message = "身份证不能为空") 
    @Pattern(regexp="^(\\d{18,18}|\\d{15,15}|(\\d{17,17}[x|X]))$", message="身份证格式错误")
    @ScriptAssert(lang="javascript",script="com.learn.validate.domain.Student.checkParams(_this.name,_this.age,_this.classes)" messgae="")  
    
    @TimeInterval(beginTime = "beginDate", endTime = "endDate", message = "申报截止日期不能在申报起始日期之前")
    
    cs