Springboot使用hibernate-validator实现参数校验

拼搏现实的明天。 2023-06-08 03:06 171阅读 0赞

***该篇只介绍关于对一个实体类内字段属性做参数校验。  
 因为我个人觉得加入拦截器AOP那种校验和直接对controller添加@Validated的这些方式，其实很多老项目是无法融入的，涉及到架构变改了。***

而对一个实体类内字段属性做参数校验这种方式，是可以不动项目架构去扩展参数校验的。

OK，我们开始编码。

对于springboot项目，hibernate-validator 的使用虽然有专属的jar包依赖：

<dependency>
        <groupId>org.hibernate</groupId>
        <artifactId>hibernate-validator</artifactId>
        <version>6.0.17.Final</version>
    </dependency>

但是在springboot的web包里也包含了这个jar，所以一般是不需要额外导入依赖的：

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

创建一个TestParams.java，这个类是用于接口接收参数的：

import lombok.Data;
    import org.hibernate.validator.constraints.Range;
    import javax.validation.constraints.NotBlank;
    import javax.validation.constraints.Pattern;
    /**
     * @Author : JCccc
     * @CreateTime : 2019/10/15
     * @Description :
     **/
    
    @Data
    public class TestParams {
    
        @NotBlank(message = "用户名不能为空")
        private String userName;
    
        @NotBlank(message = "密码不能为空")
        private String password;
    
        @NotBlank(message = "真实姓名不能为空")
        private String realName;
    
        @Range(min = 0, max = 99, message = "年龄应该在0到99之间")
        private Integer age;
    
        @Pattern(regexp = "男|女", message = "必须是男或女")
        private String sex;
    
        @Pattern(regexp = "\\d{3}-\\d{8}|\\d{4}-\\d{7}|\\d{11}", message = "号码不正确")
        private String telephone;
    
    }

PS： 这个类我用到了lombok，可以省掉很多代码，set/get /toString等等，没使用过的可以去了解下。  
lombok依赖：

<dependency>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
                <version>1.16.10</version>
                <scope>provided</scope>
            </dependency>

然后是测试接口，

@PostMapping(value = "/testValidatorPost")
        public String testValidatorPost(@Valid @RequestBody TestParams testParams) {
    
    
            return "参数校验通过："+ testParams.toString();
        }

调用这个post接口，故意传入不符合规则的参数：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70][]

返回情况是：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 1][]

这种情形，是因为在进入接口里面的逻辑前，开始了对这个testParams类参数的校验 ，校验不通过，所以直接返回400了，并且返回来很多信息，包括我们自己写的message。

但是，显然这种返回信息场景是不太能让人接受的，所以我们对这个接口稍作修改：

@PostMapping(value = "/testValidatorPost")
        public String testValidatorPost(@Valid @RequestBody TestParams testParams, BindingResult result) {
    
            if (result.hasErrors()) {
                StringBuffer errorMessage = new StringBuffer("参数校验有误：");
                for (ObjectError error : result.getAllErrors()) {
                    errorMessage = errorMessage.append(error.getDefaultMessage()).append(";");
                }
                System.out.println(errorMessage);
                return String.valueOf(errorMessage);
            }
            return "参数校验通过：" + testParams.toString();
        }

加上了BindingResult，并对errors进行逻辑处理，报错的时候也就是校验不通过时，我们进行逻辑处理。

再次调用接口（这里只是示例，我们可以将捕抓出来的message自行处理即可）：  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 2][]

同样，Get请求也一样，如果是使用类接收，还是很方便的，效果是一样的：

@GetMapping(value = "/testValidatorGet")
        public String testValidatorGet(@Valid TestParams testParams, BindingResult result) {
    
            if (result.hasErrors()) {
                StringBuffer errorMessage = new StringBuffer("参数校验有误：");
                for (ObjectError error : result.getAllErrors()) {
                    errorMessage = errorMessage.append(error.getDefaultMessage()).append(";");
                }
                System.out.println(
                        errorMessage
                );
                return String.valueOf(errorMessage);
            }
            
            return "参数校验通过：" + testParams.toString();
        }

OK,到此。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70]: /images/20230601/45c6d8e568364f49aab5e54e2b527858.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 1]: /images/20230601/23dc36272d684eac9cbb85dadcebf78b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1Mzg3OTQw_size_16_color_FFFFFF_t_70 2]: /images/20230601/7bff942b8d7e4fa8a62043c046720c78.png