我们在SpringBoot框架进行项目开发中该如何优雅的读取配置呢?或者说对于一些List或者Map应该如何配置呢?
本篇主要解决如下几个问题:
1、Spring Boot有哪些常用的读取配置文件方式?
1)使用@Value
读取配置文件
2) 使用@ConfigurationProperties
读取配置文件
3)使用Environment
读取配置文件
2、一些复杂的数据结构,如List、Map,如何配置?如何读取呢?
前言
Spring Boot默认的配置文件有两种格式:application.properties
和application.yml
。 查找顺序是首先从application.properties 查找,
如果找不到,再查找 application.yml。优先级:application.properties > application.yml。
以yml中rabbitmq的配置为例,配置文件如下:
rabbitmq:host: 127.0.0.1password: rootport: 5672username: root
一、使用 @Value 读取配置文件
这种方法适用于对象的参数比较少的情况
我们可以直接在对象的属性上使用@Value
注解,同时以${}
的形式传入配置文件中对应的属性。同时需要在该类的上方使用@Configuration
注解,将该类作为配置
文件加入,在启动项目的时候实现注入。
@Configurationpublic class RabbitmqProperties {@Value("${rabbitmq.host}")private String rabbitmqHost;@Value("${rabbitmq.port}")private String rabbitmqPort;@Value("${rabbitmq.username}")private String rabbitmqUsername;@Value("${rabbitmq.password}")private String rabbitmqPassword;}
如果哪里需要用到,通过 @Autowired 注入进去就可以获取属性值了
@Componentpublic class PropertiesTest {@Autowiredprivate RabbitmqProperties rabbitmqProperties;}
二、使用 @ConfigurationProperties 读取配置文件
如果对象的参数比较多情况下,推荐使用@ConfigurationProperties会更简单一些,不需要在每一个字段的上面的使用@Value注解。
@ConfigurationProperties
注解声明当前类为配置读取类
prefix="rabbitmq"
表示读取前缀为rabbitmq的属性
示例如下:
@ConfigurationProperties(prefix = "rabbitmq")public class RabbitmqProperties {private String host;private String port;private String username;private String password;}
这里有一点需要注意: 必须保证属性名称和字段一模一样,且类需要提供字段的setter方法
注意
如果仅仅只是使用了@ConfigurationProperties注解是没有效果的,它并不会将这个配置注入容器中,它还需要和注入容器的注解一起使用。
这里有两种方法实现将它注入到容器中
1、类上添加@Configuration注解
除了@Configuration,也可以是@Controller、@RestController、@Service、@Componet等注解,加入到Ioc容器里。
@Setter@Configuration@ConfigurationProperties(prefix = "rabbitmq")public class RabbitmqProperties {private String host;private String port;private String username;private String password;}
同样哪里需要用到,通过 @Autowired 注入进去就可以获取属性值了
2、使用@EnableConfigurationProperties注解
通过@EnableConfigurationProperties
注解可以将指定的配置读取类的对象加载到Spring容器,也就是说,在其他配置类上使用一个@EnableConfigurationProperties注解,
来将配置文件的参数和RabbitmqProperties类的属性绑定。这样就不需要在RabbitmqProperties类上使用@Configuration注解了
@Configuration@EnableConfigurationProperties(RabbitmqProperties.class)public class RabbitmqConfig {@Autowiredprivate RabbitmqProperties prop;@Beanpublic Rabbitmq rabbitmq() {Rabbitmq mq = new Rabbitmq();mq.setHost(prop.getHost());mq.setPort(prop.getPort());mq.setUsername(prop.getUsername());mq.setPassword(prop.getPassword());return mq;}}
3、使用@ConfigurationPropertiesScan扫描
在 Spring Boot 2.2.0.RELEASE 中提供了一个扫描注解@ConfigurationPropertiesScan
。它可以扫描特定包下所有的被@ConfigurationProperties
标记的配置类,
并将它们进行IoC注入。
@ConfigurationPropertiesScan@SpringBootApplicationpublic class MainApplication {public static void main(String[] args) {SpringApplication.run(MainApplication.class, args);}}
三、使用 Environment 读取配置文件
Environment 是 SpringCore 中的一个用于读取配置文件的类,将此类使用 @Autowired 注入到类中就可以使用它的getProperty方法来获取某个配置项的值。
如下代码所示:
@SpringBootApplicationpublic class MainApplication implements InitializingBean {@Autowiredprivate Environment environment;public static void main(String[] args) {SpringApplication.run(MainApplication.class, args);}@Overridepublic void afterPropertiesSet() {String username = environment.getProperty("rabbitmq.username");System.out.println("rabbitmq当前用户名为:" + username);}}
四、常用的几种数据结构配置读取
比如我们常见的字符串、整数、List、Map如何配置和读取呢?这里以之前自己开发的一个项目中用到复杂的配置数据来做示例之前有发布一个基于
Spring Cache实现二级缓存(Caffeine+Redis) 的项目,里面的配置就比较复杂。
这里展示配置示例:
application.yml
# 二级缓存配置l2cache:config:# 是否存储空值,默认true,防止缓存穿透allowNullValues: true# 组合缓存配置composite:# 是否全部启用一级缓存,默认falsel1AllOpen: false# 是否手动启用一级缓存,默认falsel1Manual: true# 手动配置走一级缓存的缓存key集合,针对单个key维度l1ManualKeySet:- userCache:user01- userCache:user02- userCache:user03- userCache:user04# 一级缓存caffeine:# 缓存刷新调度线程池的大小refreshPoolSize: 2# 写入后过期时间(秒)expireAfterWrite: 180# 访问后过期时间(秒)expireAfterAccess: 180# 初始化大小initialCapacity: 100# 最大缓存对象个数,超过此数量时之前放入的缓存将失效maximumSize: 300# 二级缓存redis:# 全局过期时间,单位毫秒,默认不过期defaultExpiration: 300000# 每个cacheName的过期时间,单位毫秒expires: {userCache: 300000,goodsCache: 50000}# 缓存更新时通知其他节点的topic名称 默认 cache:redis:caffeine:topictopic: cache:redis:caffeine:topic
配置实体类
@Data@ConfigurationProperties(prefix = "l2cache")public class L2CacheProperties {/** * 缓存配置 */private L2CacheConfig config;}
L2CacheConfig
/** *缓存配置 ** @author xub * @date 2022/9/20 下午6:02 */@Datapublic class L2CacheConfig {/** 是否存储空值,设置为true时,可防止缓存穿透 */private boolean allowNullValues = true;/** 组合缓存配置 */private final Composite composite = new Composite();/** 一级缓存配置 */private final Caffeine caffeine = new Caffeine();/** 二级缓存配置 */private final Redis redis = new Redis();/** * 组合缓存配置 */@Datapublic static class Composite {/** 是否全部启用一级缓存,默认false*/private boolean l1AllOpen = false;/** 是否手动启用一级缓存,默认false */private boolean l1Manual = false;/** 手动配置走一级缓存的缓存key集合,针对单个key维度*/private Set l1ManualKeySet = new HashSet();}/** * 一级缓存配置 */@Datapublic static class Caffeine {/** 缓存刷新调度线程池的大小 默认为 CPU数 * 2 */private Integer refreshPoolSize = Runtime.getRuntime().availableProcessors();/** 写入后过期时间,单位秒 */private long expireAfterWrite;/** 写入后刷新时间,单位秒 */private long refreshAfterWrite;/** 初始化大小 */private int initialCapacity;/** 最大缓存对象个数,超过此数量时之前放入的缓存将失效 */private long maximumSize;}/** * 二级缓存配置 */@Datapublic static class Redis {/** 全局过期时间,单位毫秒,默认不过期 */private long defaultExpiration = 0;/** 每个cacheName的过期时间,单位毫秒,优先级比defaultExpiration高 */private Map expires = new HashMap();/** 缓存更新时通知其他节点的topic名称 */private String topic = "cache:redis:caffeine:topic";}}
Configuration类
@Configuration@EnableConfigurationProperties(L2CacheProperties.class)public class CacheRedisCaffeineAutoConfiguration { @Autowired private L2CacheProperties l2CacheProperties; @Bean public RedisCaffeineCacheManager cacheManager() {return new RedisCaffeineCacheManager(l2CacheProperties.getConfig()); }}
测试
项目启动后,进行Debug打断点,看有木有注入到L2CacheProperties实体中
通过上面截图就可以看出,所有application.yml配置数据,都已经在L2CacheProperties实体中,说明配置成功,获取也成功了。