JSR-303校验 @Valid, @Validated

快来打我* 2021-11-26 23:01 374阅读 0赞

## JSR-303校验 @Valid, @Validated ##

#### 空检查 ####

*  @Null 验证对象是否为null
 *  @NotNull 验证对象是否不为null, 无法查检长度为0的字符串
 *  @NotBlank 检查约束字符串是不是Null还有被Trim的长度是否大于0,只对字符串,且会去掉前后空格
 *  @NotEmpty 检查约束元素是否为NULL或者是EMPTY.

==@NotNull是通过 null来判断

@NotEmpty是通过 .size()= =0和.length()= =0判断

@NotBlank是通过 .trim().length()= =0判断 按照实际的需求来使用

#### Booelan检查 ####

*  @AssertTrue 验证 Boolean 对象是否为 true
 *  @AssertFalse 验证 Boolean 对象是否为 false

#### 长度检查 ####

*  @Size(min=, max=) 验证对象（Array,Collection,Map,String）长度是否在给定的范围之内
 *  @Length(min=, max=) Validates that the annotated string is between min and max included.

#### 日期检查 ####

*  @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=) 检查数字是否介于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=)

#### 简单举例 ####

public class UserInfo { 
       
        @NotBlank(message = "姓名不能为空")
        private String username;
    
        // @NotEmpty(message = "密码不能为空")
        @Length(min = 6, max = 10, message = "密码长度只能在6-10之间")
        private String password;
    
        @Min(value = 18, message = "年龄最小为18")
        @Max(value = 60, message = "年龄最大为60")
        int age;
    
        @AssertTrue(message = "必须同意条款")
        boolean agree;
    }

@ResponseBody
        @GetMapping("validate")
        public Map<String, String> validate(@Valid UserInfo userInfo, BindingResult result){ 
    
            Map<String, String> map = new HashMap<String, String>();
            if (result.hasErrors()) { 
                List<ObjectError> list  = result.getAllErrors();
                for (ObjectError error :
                        list) { 
                    FieldError fieldError = (FieldError)error;
                    String defaultMessage = fieldError.getDefaultMessage();
                    String field = fieldError.getField();
                    map.put(field, defaultMessage);
                }
            }
            return map;
        }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FuZ2VyV2luZA_size_16_color_FFFFFF_t_70]

#### @Validated ####

@Valid是javax.validation里的。

@Validated是@Valid 的一次封装，是Spring提供的校验机制使用。@Valid不提供分组功能

特殊用法:

*  分组: 当一个实体类需要多种验证方式时，例：对于一个实体类的id来说，新增的时候是不需要的，对于更新时是必须的, 可以通过groups对验证进行分组

public interface AllFiled { 
    }
    
    public interface First { 
    }
    
    public interface Secend { 
    }
    
    public class UserInfo { 
        private Integer uid;
    
        @NotBlank(message = "姓名不能为空", groups = { First.class, AllFiled.class})
        private String username;
    
        @NotEmpty(message = "密码不能为空", groups = { AllFiled.class})
        @Length(min = 6, max = 10, message = "密码长度只能在6-10之间", groups = { AllFiled.class})
        private String password;
    
        //临时加的字段
        @Min(value = 18, message = "年龄最小为18", groups = { AllFiled.class})
        @Max(value = 60, message = "年龄最大为60", groups = { AllFiled.class})
        int age;
    
        //临时加的字段
        @AssertTrue(message = "必须同意条款", groups = { Secend.class, AllFiled.class})
        boolean agree;
    }
    
        @ResponseBody
        @GetMapping("validate")
        public Map<String, String> validate(@Validated({ AllFiled.class}) UserInfo userInfo, BindingResult result){ 
    
            Map<String, String> map = new HashMap<String, String>();
            if (result.hasErrors()) { 
                List<ObjectError> list  = result.getAllErrors();
                for (ObjectError error :
                        list) { 
                    FieldError fieldError = (FieldError)error;
                    String defaultMessage = fieldError.getDefaultMessage();
                    String field = fieldError.getField();
                    map.put(field, defaultMessage);
                }
            }
            return map;
        }
    }

**当@Validated分组为空时, 只会验证没有分组的属性, 如上面的uid;**

**当@Validated\{First.class\}时, 只会验证分组为First.class的字段, 对于其他分组字段和未分组字段都为空**

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FuZ2VyV2luZA_size_16_color_FFFFFF_t_70]: /images/20211126/99683091d8eb46aa8863bb2a4ebb151b.png