SpringBoot 开发秘籍 - 启动时配置校验

àì夳堔傛蜴生んèń 2022-12-02 15:28 131阅读 0赞

![format_png][]

## 概述 ##

在项目开发过程中，某个功能需要依赖在配置文件中配置的参数。这时候就可能出现下面这种现象问题：

有时候经常出现项目启动了，等到使用某个功能组件的时候出现异常，提示参数未配置或者bean注入失败。

有没有一种方法在项目启动时就对参数进行校验而不是在实际使用的时候再抛出提示呢？

答案就是使用Spring提供的Java Validation功能，简单实用。

## 增加启动校验 ##

只需要在我们创建的配置Properties类增加Validation相关配置即可

@Validated
    @Data
    @ConfigurationProperties(prefix = "app")
    @Component
    public class AppConfigProperties {
        @NotEmpty(message = "配置文件配置必须要配置[app.id]属性")
        private String id;
    }

上面的配置就会校验我们在 `application.yml`中有没有配置 `app.id`参数。如果在配置文件中没有该配置，项目启动就会失败，并抛出校验异常。

> 在使用配置文件校验时，必须使用@configurationproperties注解，@value不支持该注解。

在需要使用app.id的时候注入配置类即可：

@Autowired
    private AppConfigProperties appConfigProperties;

这样就可以实现我们想要的效果，如下图：

![format_png 1][] 效果

### 校验类型 ###

<table> 
 <thead> 
  <tr> 
   <th>校验规则</th> 
   <th>规则说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>@Null</td> 
   <td>限制只能为null</td> 
  </tr> 
  <tr> 
   <td>@NotNull</td> 
   <td>限制必须不为null</td> 
  </tr> 
  <tr> 
   <td>@AssertFalse</td> 
   <td>限制必须为false</td> 
  </tr> 
  <tr> 
   <td>@AssertTrue</td> 
   <td>限制必须为true</td> 
  </tr> 
  <tr> 
   <td>@DecimalMax(value)</td> 
   <td>限制必须为一个不大于指定值的数字</td> 
  </tr> 
  <tr> 
   <td>@DecimalMin(value)</td> 
   <td>限制必须为一个不小于指定值的数字</td> 
  </tr> 
  <tr> 
   <td>@Digits(integer,fraction)</td> 
   <td>限制必须为一个小数，且整数部分的位数不能超过integer，小数部分的位数不能超过fraction</td> 
  </tr> 
  <tr> 
   <td>@Future</td> 
   <td>限制必须是一个将来的日期</td> 
  </tr> 
  <tr> 
   <td>@Max(value)</td> 
   <td>限制必须为一个不大于指定值的数字</td> 
  </tr> 
  <tr> 
   <td>@Min(value)</td> 
   <td>限制必须为一个不小于指定值的数字</td> 
  </tr> 
  <tr> 
   <td>@Past</td> 
   <td>验证注解的元素值（日期类型）比当前时间早</td> 
  </tr> 
  <tr> 
   <td>@Pattern(value)</td> 
   <td>限制必须符合指定的正则表达式</td> 
  </tr> 
  <tr> 
   <td>@Size(max,min)</td> 
   <td>限制字符长度必须在min到max之间</td> 
  </tr> 
  <tr> 
   <td>@NotEmpty</td> 
   <td>验证注解的元素值不为null且不为空（字符串长度不为0、集合大小不为0）</td> 
  </tr> 
  <tr> 
   <td>@NotBlank</td> 
   <td>验证注解的元素值不为空（不为null、去除首位空格后长度为0），不同于@NotEmpty，@NotBlank只应用于字符串且在比较时会去除字符串的空格</td> 
  </tr> 
  <tr> 
   <td>@Email</td> 
   <td>验证注解的元素值是Email，也可以通过正则表达式和flag指定自定义的email格式</td> 
  </tr> 
 </tbody> 
</table>

Validation 支持如下几种校验，可以满足基本的业务逻辑，当然如果还是满足不了你的业务逻辑，可以选择定制校验规则。

### 定制校验逻辑 ###

1.  定义校验逻辑规则，实现 `org.springframework.validation.Validator`

public class ConfigPropertiesValidator implements Validator {
        @Override
        public boolean supports(Class<?> aClass) {
            return AppConfigProperties.class.isAssignableFrom(aClass);
        }
    
        @Override
        public void validate(Object o, Errors errors) {
            AppConfigProperties config = (AppConfigProperties) o;
            if(StringUtils.isEmpty(config.getId())){
                errors.rejectValue("id", "app.id.empty", "[app.id] 属性必须要在配置文件配置");
            }else if (config.getId().length() < 5) {
                errors.rejectValue("id", "app.id.short", "[app.id] 属性的长度必须不能小于5");
            }
        }
    }

1.  使用自定义校验规则就不需要在使用原生的@NotEmpty了，将其删除

@Validated
    @Data
    @ConfigurationProperties(prefix = "app")
    @Component
    public class AppConfigProperties {
    //    @NotEmpty(message = "配置文件配置必须要配置[app.id]属性")
        private String id;
    }

1.  注入自定义校验规则

@Bean
    public  ConfigPropertiesValidator configurationPropertiesValidator(){
      return new ConfigPropertiesValidator();
    }

**「注意：这里bean的方法名必须要 configurationPropertiesValidator，否则启动的时候不会执行该校验」**

1.  修改app.id配置，观察启动情况

![format_png 2][]

测试验证结果

错误信息即为我们自定义校验的结果。

## 小结 ##

通过配置Spring Boot启动校验功能，可以快速的识别参数配置的错误，避免在使用组件的时候才发现问题，可以减少排查问题的工作量，并且在我们封装自定义的starter时可以有更好的体验。

如果本文对你有帮助，

别忘记给我个三连：

点赞，转发，评论

。

咱们下期见！

**收藏 ****等于白嫖****，****点赞 ****才是真情！**

End

干货分享

这里为大家准备了一份小小的礼物，关注公众号，输入如下代码，即可获得百度网盘地址，无套路领取！  
  
001：《程序员必读书籍》  
002：《从无到有搭建中小型互联网公司后台服务架构与运维架构》  
003：《互联网企业高并发解决方案》  
004：《互联网架构教学视频》  
006：《SpringBoot实现点餐系统》  
007：《SpringSecurity实战视频》  
008：《Hadoop实战教学视频》

010： 微信交流群

近期热文top

1、[关于JWT Token 自动续期的解决方案][JWT Token]

2、[还不了解ETL，看看这篇文章？][ETL]

[3、为什么微服务需要api网关][3_api]

4、[架构师之路-微服务技术选型][-]

[5、RocketMQ进阶 - 事务消息][5_RocketMQ_-]

![format_png 3][]

我就知道你“在看”

![format_png 4][]

[format_png]: /images/20221123/d266a74b0b2745889ebd53390ad55fbe.png
[format_png 1]: /images/20221123/e5e47470620d498ab8c8f85b51626547.png
[format_png 2]: /images/20221123/70161e258b4b430ebea04a428a117d73.png
[JWT Token]: http://mp.weixin.qq.com/s?__biz=MzAwMTk4NjM1MA%3D%3D&chksm=9ad01e39ada7972f6876967c5056be292429a4a16ef8b6c0ebdee48b7952718437b449856df3&idx=1&mid=2247484536&scene=21&sn=1b93b86e1fe8ca7ac36475bdd65fcaf8#wechat_redirect
[ETL]: http://mp.weixin.qq.com/s?__biz=MzAwMTk4NjM1MA%3D%3D&chksm=9ad01e71ada797676fa87d81b687b9ceb7afb1782d0ef0005912865a934acb02c157adf257cd&idx=1&mid=2247484464&scene=21&sn=71534da884366274e66d047c7db07619#wechat_redirect
[3_api]: http://mp.weixin.qq.com/s?__biz=MzAwMTk4NjM1MA%3D%3D&chksm=9ad01eadada797bbd93eee0453baa1dd57ce5b7edb80a771b904730a29d689cb4b3113380ea0&idx=1&mid=2247484652&scene=21&sn=bf479139ddbc3b352a28b30b6ab4e0d1#wechat_redirect
[-]: http://mp.weixin.qq.com/s?__biz=MzAwMTk4NjM1MA%3D%3D&chksm=9ad019b9ada790af289e5936cd70967805e8f670290dd594e3ba5f56dc2924e213ffeedae81d&idx=1&mid=2247484408&scene=21&sn=b191b70d82c047c97450eb8e09191935#wechat_redirect
[5_RocketMQ_-]: http://mp.weixin.qq.com/s?__biz=MzAwMTk4NjM1MA%3D%3D&chksm=9ad01e56ada797400a12c959bacb080c7ad8ed11ed7454b8c64b531b86394811938896185295&idx=1&mid=2247484439&scene=21&sn=fb233c2ab321afee25c207799b9e4477#wechat_redirect
[format_png 3]: /images/20221123/daccdb9397b94f8280947209ce9c28f4.png
[format_png 4]: /images/20221123/e476bf4065de444d9af549a811a40aab.png