大家好,我叫Jensen。
在项目开发过程中,某个功能需要依赖在配置文件中配置的参数。这时候就可能出现下面这种现象:
有时候经常出现项目启动了,等到使用某个功能组件的时候出现异常,提示参数未配置或者bean注入失败。
那有没有一种方法在项目启动时就对参数进行校验而不是在实际使用的时候再抛出提示呢?
当然可以,答案就是使用Spring提供的Java Validation功能,简单实用。
Validation不是做参数校验的吗?居然还可以干这种事!
0x1.开启启动时参数校验
只需要在我们创建的配置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;
这样就可以实现我们想要的效果,如下图:
0x2.支持校验类型
Validation 支持如下几种校验,可以满足基本的业务逻辑,当然如果还是满足不了你的业务逻辑,可以选择定制校验规则。
0x3.定制校验逻辑
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");
}
}
}
2、使用自定义校验规则就不需要再使用原生的@NotEmpty了,将其删除
@Validated
@Data
@ConfigurationProperties(prefix = "app")
@Component
public class AppConfigProperties {
// @NotEmpty(message = "配置文件配置必须要配置[app.id]属性")
private String id;
}
3、注入自定义校验规则
@Bean
public ConfigPropertiesValidator configurationPropertiesValidator(){
return new ConfigPropertiesValidator();
}
注意:这里bean的方法名必须要使用 configurationPropertiesValidator,否则启动的时候不会执行该校验
4、修改app.id配置,观察启动情况
错误信息即为我们自定义校验的结果。
0x4.小结
通过配置Spring Boot启动校验功能,可以快速的识别参数配置的错误,避免在使用组件的时候才发现问题,可以减少排查问题的工作量,并且在我们封装自定义starter时可以有更好的体验。试想一下,你们很多项目共用部门一个Redis集群,那不同项目之间肯定要进行key隔离,这时候你提供一个公共的redis starter,强制必须在使用时指定app.id作为redis的自定义key前缀,岂不是会受到领导大大的赞美?
本文作者:Jensen
7年Java老兵,小米主题设计师,手机输入法设计师,ProcessOn特邀讲师。
曾涉猎航空、电信、IoT、垂直电商产品研发,现就职于某知名电商企业。
技术公众号【架构师修行录】号主,专注于分享日常架构、技术、职场干货,关注回复“DDD”领学习DDD领域建模。
交个朋友,一起成长!