Spring注解用法，随用随更

1. @Valid

功能：对接口方法的入参进行校验

• 实体类

@Data
public class User {

    @NotNull(message = "ID不能为空")
    @Range(message = "ID范围为 {min} 到 {max} 之间",min = 0,max = 200)
    private Long id;

    @NotBlank(message = "姓名不能为空")
    @Length(message = "姓名不能超过{max}个字",max = 10)
    private String name;

}

• Controller层，参数上添加@Valid注解，并传入BindingResult对象，用于获取校验失败情况下的反馈信息

@Controller
@RequestMapping("/user")
public class TestController {
 
    @PostMapping("/add")
    @ResponseBody
    public R add(@Valid @RequestBody User user, BindingResult bindingResult) {
        if(bindingResult.hasErrors()){
            return R.error().put("data", bindingResult.getAllErrors().get(0).getDefaultMessage());
        }
        return R.ok();
    }
 
}

• 不传入BindingResult对象，如果入参参数校验未通过，不会进入方法内，返回结果如下：

{
    "timestamp": "2022-06-19T10:06:11.218+00:00",
    "status": 400,
    "error": "Bad Request",
    "path": "/test"
}

• 相关注解

@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格式