SpringBoot 开发秘籍 - 启动时配置校验-阿里云开发者社区

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

2021-12-09 151

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： 在项目开发过程中，某个功能需要依赖在配置文件中配置的参数。

概述

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

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

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

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

增加启动校验

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

@Validated@Data@ConfigurationProperties(prefix="app")
@ComponentpublicclassAppConfigProperties {
@NotEmpty(message="配置文件配置必须要配置[app.id]属性")
privateStringid;
}

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

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

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

@AutowiredprivateAppConfigPropertiesappConfigProperties;

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

aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9QeE16VDBPaWJmNGdUNWhvTkM0U2VpYWFaVUkzWVJqTGljTjNhb1FFa0ZaUEpMeThlaG45c1Zvc3JCVE1ZUGJYamljRGliWlJhbXhCdWQxWEJGU2daVEloTWNnLzY0MA.png

效果

校验类型

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

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

。

定制校验逻辑

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

publicclassConfigPropertiesValidatorimplementsValidator {
@Overridepublicbooleansupports(Class<?>aClass) {
returnAppConfigProperties.class.isAssignableFrom(aClass);
    }
@Overridepublicvoidvalidate(Objecto, Errorserrors) {
AppConfigPropertiesconfig= (AppConfigProperties) o;
if(StringUtils.isEmpty(config.getId())){
errors.rejectValue("id", "app.id.empty", "[app.id] 属性必须要在配置文件配置");
        }elseif (config.getId().length() <5) {
errors.rejectValue("id", "app.id.short", "[app.id] 属性的长度必须不能小于5");
        }
    }
}

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

@Validated@Data@ConfigurationProperties(prefix="app")
@ComponentpublicclassAppConfigProperties {
//    @NotEmpty(message = "配置文件配置必须要配置[app.id]属性")privateStringid;
}

注入自定义校验规则

@BeanpublicConfigPropertiesValidatorconfigurationPropertiesValidator(){
returnnewConfigPropertiesValidator();
}

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

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

aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9QeE16VDBPaWJmNGdUNWhvTkM0U2VpYWFaVUkzWVJqTGljTmxrVVduUEEzNUZYQmo2OWhxSHBoTG9jbHloc3JWMlpLSGw1dWlhNGpZTFE5UDg3SjNlT2RFMEEvNjQw.png