二、spring-boot-starter-validation开启参数校验使用详解

注解说明

spring关于数据校验的代码位于org.springframework.validation包下，其核心注解为@Validated，添加注解开启校验功能，如果数据异常则会统一抛出异常，方便异常中心统一处理。

参数验证 @Validated 和 @Valid 的区别：

1. 所属框架：@Validated由spring框架提供，@Valid由validation框架提供
2. 使用位置：@Validated可以用在类型、方法和方法参数上，但是不能用在成员属性上；
   @Valid可以用在方法、构造函数、方法参数和成员属性上
3. 分组：@Validated提供了一个分组功能，可以在入参验证时，根据不同的分组采用不同的验证机制

GitHub地址
hibernate-validator支持注解及XML方式的进行数据校验。

javax.validation.constraints包下提供的注解：

hibernate也扩展了很多注解，位于org.hibernate.validator.constraints包下：

spring boot使用@Validated案例

在实际开发中，后台数据校验一般放在controller层，使用@Validated集合hibernate提供的一些列注解，可以很轻松优雅的实现数据校验的功能。

空检验

@NotEmpty 用在集合类上面，@NotBlank 用在String上面，包括””和null，@NotNull 用在基本类型上，包括null

1. @Null 验证对象是否为null

2. @NotNull 验证对象是否不为null， 无法查检长度为0的字符串

3. @NotBlank 检查约束字符串是不是Null还有被Trim的长度是否大于0，只对字符串，且会去掉前后空格.

4. @NotEmpty 检查约束元素是否为NULL或者是EMPTY.

案例演示：

1. 创建一个实体类

@ToString
@Data
public class User {
   

    @NotEmpty(message = "用户名不能为空")
    String userName;
    @NotNull(message = "密码不能为null")
    String password;
    int age;
    boolean isRegistered;

2. 在controller方法上开启数据校验

    @GetMapping("/test001")
    public Object test001(@@Validated User user){
   
        return user;
    }

3. 访问http://localhost:8000/test/test001?userName=111，发生异常，数据校验成功
   

布尔校验

1. @AssertTrue ：验证 Boolean 对象是否为 true
2. @AssertFalse：验证 Boolean 对象是否为 false

案例演示：

1. isRegistered属性添加注解

    @AssertTrue(message = "注册状态必须为true")
    boolean isRegistered;

2. 访问http://localhost:8000/test/test001?userName=111&password=123456&isRegistered=false，发生异常
   

长度校验

1. @Size(min=， max=) 验证对象（Array，Collection，Map，String）长度是否在给定的范围之内
2. @Length(min=， max=) 验证字符串是否在最小值和最大值之间

案例演示：

1. 对密码长度进行校验

    @NotNull(message = "密码不能为null")
    @Length(min = 10, max = 20, message = "密码长度必须在10-20之间")
    String password;

2. 访问http://localhost:8000/test/test001?userName=111&password=123456&isRegistered=false，发生异常
   

日期校验

1. @Past：验证 Date 和 Calendar 对象是否在当前时间之前
2. @Future：验证 Date 和 Calendar 对象是否在当前时间之后

案例演示：

1. 对生日进行校验

@Past(message = "生日不能小于当前时间")
Date birthday;

2. 访问http://localhost:8000/test/test001?birthday=2022/12/02%2010:50:25，发生异常
   

正则表达式校验

1. @Pattern：验证 String 对象是否符合正则表达式的规则

案例演示：

1. 对用户名进行数字字母正则校验

    @Pattern(message = "用户名只能是数字字母",regexp = "^[A-Za-z0-9-]*")
    String userName;

数值校验

建议使用在Stirng，Integer类型，不建议使用在int类型上，因为表单值为“”时无法转换为int，但可以转换为Stirng为""，Integer为null。

1. @Min：验证 Number 和 String 对象是否大等于指定的值
2. @Max：验证 Number 和 String 对象是否小等于指定的值
3. @DecimalMax：被标注的值必须不大于约束中指定的最大值. 这个约束的参数是一个通过BigDecimal定义的最大值的字符串表示.小数存在精度
4. @DecimalMin ：被标注的值必须不小于约束中指定的最小值. 这个约束的参数是一个通过BigDecimal定义的最小值的字符串表示.小数存在精度
5. Digits(integer=，fraction=)：验证 Number 和 String 的构成是否合法 ，interger指定整数精度，fraction指定小数精度。
6. @Range(min=， max=) 检查数字是否介于min和max之间

案例演示：

    @Min(value = 1, message = "年龄不能小于1")
    @Max(value = 150, message = "年龄不能大于100")
    int age;
    @DecimalMax(message = "金额不能大于99.99",value = "99.99")
    @DecimalMin(message = "金额不能小于0.99",value = "0.99")
    Double money;
    @Range(min = 1,max = 200,message = "年龄必须在1-200之间")
    int age;
    @Digits(integer = 3, fraction = 2,message = "金额的整数不能超过3位，小数部分不能超过2位")
    Double money;

其他校验

1. @Valid 递归的对关联对象进行校验， 如果关联对象是个集合或者数组，那么对其中的元素进行递归校验，如果是一个map，则对其中的值部分进行校验
2. @Email 验证是否是邮件地址，如果为null，不进行验证，算通过验证。
3. @ScriptAssert(lang= ，script=， alias=) 类级约束，评估一个脚本表达对注释的元素
4. @URL(protocol=，host=， port=，regexp=， flags=) 验证URL地址是否有效

转载：https://blog.csdn.net/qq_43437874/article/details/116988733