常用注解之校验注解

一.@Valid与@Validated注解介绍

1.作用：

@Valid与@Validated都是用来校验接收参数的。

2.区别：

1. @Validated：可以用在类型、方法和方法参数上。但是不能用在成员属性（字段）上，不支持嵌套检测

2. @Valid：可以用在方法、构造函数、方法参数和成员属性（字段）上，支持嵌套检测

 3.使用@Valid注解的pom依赖

    <dependency>

          <groupId>org.springframework.boot</groupId>

          <artifactId>spring-boot-starter-validation</artifactId>

   </dependency>

4.@Valid实现嵌套检测

       嵌套检测就是在一个beanA中，存在另外一个beanB属性。嵌套检测beanA同时也检测beanB。例如：

public class AgeBean {

    @NotNull(message = "年龄不能为空")

    @Max(value = 120,message = "年龄不能超过120岁")

    @Min(value = 0,message = "年龄不能为负数")

     private int age;

}

public class LoginUser {

    @NotBlank(message = "手机号码不能为空")

    private String phone;

   @NotBlank(message = "密码不能为空")

    private String passWord;

   @NotNull(message = "ageBean不能为null")

   private AgeBean ageBean

}

注意：LoginUser中ageBean属性没有添加@Valid注解，所以只能检测ageBean属性不为空，但是不能检测AgeBean对象中age属性定义的最大值和最小值。（@Validated不能添加属性上面，不支持嵌套检测所以只有使用@Valid）

嵌套验证

@Validated：用在方法入参上无法单独提供嵌套验证功能。不能用在成员属性（字段）上，也无法提示框架进行嵌套验证。能配合嵌套验证注解@Valid进行嵌套验证

@Valid：用在方法入参上无法单独提供嵌套验证功能。能够用在成员属性（字段）上，提示验证框架进行嵌套验证。能配合嵌套验证注解@Valid进行嵌套验证。也就是说单独一个@Validated或者@Valid都无法提供嵌套验证功能，都需要再结合一个@Valid注解进行嵌套验证

5.常用注解说明

@AssertFalse：

此注解的元素必须是Boolean类型，并且值为false

@AssertTrue：

此注解的元素必须是Boolean类型，并且值为true

@DecimalMax：

此注解的元素必须是数字，并且值要小于或等于给定的BigDecimalString值

@DecimalMin：

此注解的元素必须是数字，并且值要大于或等于给定的BigDecimalString值

@Digits：

此注解的元素必须是数字，并且它的值必须有指定的位数

@Email：

此注解的元素要匹配指定的正则表达式

@Max：

此注解的元素必须是数字，并且值要小于或等于给定的值。注意如果@Max所注解的元素是null，则@Max注解会返回true，所以应该把@Max注解和@NotNull注解结合使用

@Min：

此注解的元素必须是数字，并且值要大于或等于给定的值。注意如果@Min所注解的元素是null，则@Min注解会返回true，即也会通过校验，所以应该把@Min注解和@NotNull注解结合使用。

@NotBlank：

此注解的元素不能为null且不能为空白，并且必须至少包含一个非空白字符，用于校验CharSequence(含String、StringBuilder和StringBuffer)。只支持字符类型。

@NotEmpty：

此注解的元素不能为null且长度大于0，可以是空白，用于校验CharSequence、数组、Collection和Map

@NotNull：

此注解的元素不能为null，接受任何类型

@Null：

此注解的元素必须为null，接受任何类型

@Pattern：

此注解的元素必须匹配指定的正则表达式。注意如果@Pattern所注解的元素是null，则@Pattern注解会返回true，即也会通过校验，所以应该把@Pattern注解和@NotNull注解结合使用

@Size：

此注解的元素必须符合指定的大小,该注解可用于数组，CharSequence(含String、StringBuilder和StringBuffer)，Collection和Map。注意如果@Size所注解的元素是null，则@Size注解会返回true，即也会通过校验，所以应该把@Size注