SpringBoot开发技巧启动时配置校验实现示例
概述
在项目开发过程中，某个功能需要依赖在配置文件中配置的参数。这时候就可能出现下面这种现象问题：
有时候经常出现项目启动了，等到使用某个功能组件的时候出现异常，提示参数未配置或者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;
这样就可以实现我们想要的效果，如下图：
效果
校验类型
| 校验规则 | 规则说明 |
|---|---|
| @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，也可以通过正则表达式和flag指定自定义的email格式 |
Validation 支持如下几种校验，可以满足基本的业务逻辑，当然如果还是满足不了你的业务逻辑，可以选择定制校验规则。
定制校验逻辑
定义校验逻辑规则，实现 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");
}
}
}
使用自定义校验规则就不需要在使用原生的@NotEmpty了，将其删除
@Validated
@Data
@ConfigurationProperties(prefix = "app")
@Component
public class AppConfigProperties {
// @NotEmpty(message = "配置文件配置必须要配置[app.id]属性")
private String id;
}
注入自定义校验规则
@Bean
public ConfigPropertiesValidator configurationPropertiesValidator(){
return new ConfigPropertiesValidator();
}
注意：这里bean的方法名必须要 configurationPropertiesValidator，否则启动的时候不会执行该校验
修改app.id配置，观察启动情况
错误信息即为我们自定义校验的结果。
小结
通过配置Spring Boot启动校验功能，可以快速的识别参数配置的错误，避免在使用组件的时候才发现问题，可以减少排查问题的工作量，并且在我们封装自定义的starter时可以有更好的体验。
以上就是SpringBoot开发技巧启动时配置校验实现示例的详细内容，更多关于SpringBoot启动时配置校验的资料请关注脚本之家其它相关文章！
相关文章
这篇文章主要介绍了Java并发编程之原子变量与非阻塞同步机制,本文讲解了非阻塞算法、悲观技术、乐观技术、CAS操作、原子变量、性能比较：锁与原子变量等内容,需要的朋友可以参考下2015-04-04
这篇文章主要介绍Java多线程之同步工具类CyclicBarrier,它是一个同步工具类，它允许一组线程互相等待，直到达到某个公共屏障点，支持一个可选的Runnable命令，在一组线程中的最后一个线程到达之后,该命令只在每个屏障点运行一次。下面来看文章具体内容2021-10-10
这篇文章主要介绍了SpringBoot自动配置原理分析，SpringBoot是我们经常使用的框架，那么你能不能针对SpringBoot实现自动配置做一个详细的介绍。如果可以的话，能不能画一下实现自动配置的流程图。牵扯到哪些关键类，以及哪些关键点2022-08-08
这篇文章主要介绍了java方法重写,较为详细的讲述了Java方法重写的注意事项,并附带实例加以说明,需要的朋友可以参考下2014-09-09
SpringBoot之bootstrap和application的区别解读
这篇文章主要介绍了SpringBoot之bootstrap和application的区别及说明，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2023-03-03
本文主要介绍了Maven设置JDK版本的两种方法实现,是通过Apache Maven Compiler Plugin插件实现的,具有一定的参考价值,感兴趣的可以了解一下2024-07-07
这篇文章主要介绍了Java线程中Thread方法下的Join方法详解,在项目中往往会遇到这样一个场景,就是需要等待几件事情都给做完后才能走下面的事情,这个时候就需要用到Thread方法下的Join方法,join方法是无参且没有返回值的,需要的朋友可以参考下2024-01-01
这篇文章主要介绍了Java对象创建内存案例解析,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下2021-08-08
这篇文章主要介绍了JVM系列之:再谈java中的safepoint说明，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2020-09-09
这篇文章主要分析了SpringBoot的启动原理，帮助大家更好的理解和使用spring boot框架，感兴趣的朋友可以了解下2020-09-09
最新评论