JSR-303校验 @Valid, @Validated

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;
    }

@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的字段, 对于其他分组字段和未分组字段都为空