SpringBoot整合Validation进行参数校验

青旅半醒 2022-12-22 12:29 204阅读 0赞

### 目录 ###

*   *   *  依赖
         *  在controller中校验接收到的参数
         *  Validation常用注解
         *  异常处理
         *  多级嵌套校验
         *  分组校验

spring、lombok提供了一些参数校验的注解，比如@Nullable、@NonNull ，但比较鸡肋，常用Validation的注解来校验controller接收到的参数。

以springboot整合validation为例。

### 依赖 ###

创建时勾选 I/O -> Validation，也可以手动添加依赖

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-validation</artifactId>
    </dependency>

### 在controller中校验接收到的参数 ###

@Controller
    @Validated  //controller上加spring的注解@Validated
    public class TestController { 
    
        @RequestMapping("/handler1")
        @ResponseBody
        // 如果要校验的参数是jdk自带的类型（包括数组、集合），可直接在参数前加注解
        public User handler1(@NotNull String name, String tel, @Email String email, @NotEmpty String[] hoby) { 
            return new User(1, name, tel, email, hoby);
        }
        
        @RequestMapping("/handler2")
        @ResponseBody
        // 如果要校验的参数是实体类，在实体类参数前加@Validated，校验的注解加在实体类的成员变量上
        public User handler2(@Validated User user) { 
            return user;
        }
        
    }

@Getter
    @Setter
    @ToString
    @AllArgsConstructor
    public class User implements Serializable { 
    
        private Integer id;
    
        @NotNull
        private String name;
    
        private String tel;
    
        @Email
        private String email;
    
        @NotEmpty
        private String[] hoby;
    
    }

### Validation常用注解 ###

@NotNull  //常用于校验包装类型、数组，不能为null
    @NotEmpty  //校验包装类型、String、数组、集合，不能为null。如果是集合、数组，里面要有元素；如果是字符串，不能为空串，但可以是空格串
    @NotBlank  //校验String，不能为null，且不能为空串、空格串
    
    //如果是String，不管前端有没有传该字段、该字段是否有值，后端该字段一定不为null，要用@NotEmpty|@NotBlank不能用@NotNull
    //如果是数组（复选框），后端会先检验数组中是否有元素，有才new一个数组来接收，可以用@NotNull来校验
    //总结：包装类用NotNull，String用@NotEmpty|@NotBlank，数组用@NotNull|@NotEmpty
    
    
    @Max(100)  //校验数值型，参数指定允许的最大值（long型），value=100，此处简写了
    @Min(1)
    @Range(min = 1,max = 100)   //校验数值型的范围，相当于@Min+@Max
    
    
    @DecimalMax(@DecimalMax(value = "100.00",inclusive = false)  //校验定点型，可指定String类型的最大值，是否包含该值（默认true）
    @DecimalMin("0.0")
    
    
    @Digits(integer = 4,fraction = 2)  //校验数值型，限定整数部分最多4位，小数部分最多2位
    
    
    @Future  //校验Date，必须大于当前时间，即必须是未来
    @Past
    
    
    @Email   //必须是email格式
    @URL  //必须是url格式
    
    
    @Length(min = 5, max = 10)  //校验字符串、数组长度（leng），【5,10】
    @Size(min = 5, max = 10)  //校验集合的元素个数（size），【5,10】
    
    
    @Pattern(regexp = "\\d+",message = "只能输入1个或多个阿拉伯数字") //使用指定的正则表达式进行校验，\d+，第一个\是转义用的

不满足条件时会抛出 ConstraintViolationException 异常，可在全局异常处理中捕获，获取message返回给前端。

以上注解均可指定message，如果不指定会使用默认的message。建议都指定message，返回给前端的提示更友好。

如果Validation的校验注解不能满足需求，可以在方法中写代码校验参数，或者自定义校验注解。

### 异常处理 ###

/** * 全局异常处理 */
    @ControllerAdvice
    public class GlobalExceptionHandler { 
    
        //......
        
        @ExceptionHandler(ConstraintViolationException.class)
        @ResponseBody
        public Map<String,String> handler(ConstraintViolationException e){ 
            Map<String, String> map = new HashMap<>(4);
            map.put("code", "400");
            map.put("msg", e.getMessage());
            return map;
        }
        
        //.......
    
    }

### 多级嵌套校验 ###

@Controller
    @Validated
    public class TestController { 
    
        @RequestMapping("/handler")
        @ResponseBody
        //要校验的参数是实体类
        public User handler( @Validated User user) { 
            //.....
            return user;
        }
    
    }

@Getter
    @Setter
    @ToString
    public class User implements Serializable { 
    
        //......
    
        @Valid  //加@Valid
        private GoodsCar goodsCar;
    
        @Valid  //加@Valid
        private List<Order> orderList;
    
    }

如果要检验的参数是实体类，而这个实体类中又嵌套了实体类，如果要校验内嵌的实体类中的成员变量，还需要在内嵌的实体类成员上加@Valid。

spring的 @Validated 不支持多级嵌套校验，Validation的 @Valid 则支持。

### 分组校验 ###

多个方法都要使用某个实体类作为参数，但对这个实体类的成员变量的校验规则不同，这时可以使用分组校验。

/** * 定义一个类|接口作为一个分组，不一定要继承validation的Default * 也可以直接使用已存在的类|接口作为分组 */
    public interface OperateById { 
    
    }
    
    
    public interface FindByUser extends Default { 
    
    }

@Getter
    @Setter
    @ToString
    public class User implements Serializable { 
    
    	//使用groups指定该字段所属的分组，属于多个组时写成数组形式
        @NotNull(groups = { OperateById.class, FindByUser.class})
        private Integer id;
    
        @NotBlank(groups = FindByUser.class)
        private String name;
    
    	//如果缺省groups属性，默认为Default.class，属于默认分组
    	@Pattern(regexp = "[0-9]{11}")
        private String tel;
    
    }

@Controller
    @Validated
    public class TestController { 
    
        @RequestMapping("/handler")
        @ResponseBody
        //校验时指定所使用的校验规则（分组），可简写为 @Validated(FindByUser.class)。缺省value属性时默认为Default.class，使用默认分组
        public User handler( @Validated(value = FindByUser.class) User user) { 
            //.....
            return user;
        }
    
    }

校验时会使用指定分组中的校验规则进行校验。示例中

*  OperateById分组只校验id字段是否满足@NotNull
 *  默认分组只校验tel字段是否为11位的阿拉伯数字
 *  FindByUser分组会校验id字段是否满足@NotNull、name字段是否满足@NotBlank，因为FindByUser继承了Default，所以也会校验默认分组中的字段

自定义的分组要不要继承Default，视需求而定。