【优雅的参数验证@Validated】@Validated参数校验的使用及注解详解——你还在用if做条件验证？

本文介绍: 你还在用i f做条件验证？【优雅的参数验证@Vali date d】–@Vali date d 参数校验的使用及注解详解

    @ApiOperation("新增用户")
    @PostMapping("/addUser")
    public ResultVo insert(@ApiParam("用户信息实体") @RequestBody User user){
        if(user.getUserName!=null){
           throw new BusinessException("用户名称不能为空");
        }
        if(user.getUserPhone!=null){
           throw new BusinessException("用户电话不能为空");
        }
        if( user.getUserPhone().length()){
           throw new BusinessException("用户电话格式不规范");
        }
        return new ResultVo(userService.insert(user));
    }

以上代码主要是为了对用户 user实体进行条件验证。
但是那么多的if，写得纯纯得小白一个，也使得代码显得臃肿不美观不优雅！
接下来，让我们学习使用优雅的参数验证@Vali dated！

二者主要作用在于 都作为标准JSR-303规范，在检验Controller的入参是否符合规范时，使用@Vali dated或者@Valid在基本验证功能上没有太多区别。但是在分组、注解地方、嵌套验证等功能上两个有所不同：

@Valid:
@Valid 注解用于校验，所属包为：javax.validation.Valid。

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

        <!--第一种方式导入校验依赖：使用springboot时，在orgspringframeworkspring-context5.2.1.RELEASEspring-context-5.2.1.RELEASE.jar--&gt;
		<dependency&gt;
            <groupId&gt;org.springframework.boot</groupId&gt;
            <artifactId&gt;spring-boot-starter</artifactId>
        </dependency>
        <!--第二种方式导入校验依赖-->
        <dependency>
            <groupId>javax.validation</groupId>
            <artifactId>validation-api</artifactId>
            <version>2.0.1.Final</version>
        </dependency>
        <!--第三种方式导入校验依赖-->
        <dependency>
            <groupId>org.hibernate.validator</groupId>
            <artifactId>hibernate-validator</artifactId>
        </dependency>

    @ApiOperation("新增用户")
    @PostMapping("/addUser")
    public ResultVo insert(@ApiParam("用户信息实体") @Validated(addUser.class) @RequestBody User user){
        return new ResultVo(userService.insert(user));
    }

/**自定义条件注解
 * @author： wxh
 * @version：v1.0
 * @date： 2022/11/14 22:39
 */
@Target({ElementType.FIELD,ElementType.METHOD,ElementType.ANNOTATION_TYPE,ElementType.CONSTRUCTOR,ElementType.PARAMETER,ElementType.TYPE_USE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Constraint(validatedBy = {ListValueConstraintValidator.class})
public @interface ListValue {
    //配置路径，后端传递信息
    String message() default "{com.itfuture.e.valid.ListValue.message}";
    
    Class<?>[] groups() default {};

    Class<? extends Payload>[] payload() default {};

    //自定义一个类型来存放数据（数组）
    int[] values() default {};

}

/**自定义显示状态
 * @author： wxh
 * @version：v1.0
 * @date： 2022/11/14 22:49
 */
public class ListValueConstraintValidator implements ConstraintValidator<ListValue,Integer> {
    //set存储
    private Set<Integer> set = new HashSet<>();

    //初始化数据
    //listValue拿到的是注解中的数据
    @Override
    public void initialize(ListValue constraintAnnotation) {
        //拿到注解中自定义的数据，且是数组型的
        int[] values = constraintAnnotation.values();
        //放在数组里，遍历判断
        for(int value:values){
            set.add(value);
        }
    }

    //判断数据是否相同
    @Override
    public boolean isValid(Integer integer, ConstraintValidatorContext constraintValidatorContext) {
        if(set.contains(integer)){
            return true;
        }
        return false;
    }
}