0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

有哪些方法可以读取Springboot的配置呢?

OSC开源社区 来源:程序员小富 2023-06-28 10:00 次阅读

从配置文件中获取属性应该是SpringBoot开发中最为常用的功能之一,但就是这么常用的功能,仍然有很多开发者在这个方面踩坑。

我整理了几种获取配置属性的方式,目的不仅是要让大家学会如何使用,更重要的是弄清配置加载、读取的底层原理,一旦出现问题可以分析出其症结所在,而不是一报错取不到属性,无头苍蝇般的重启项目,在句句卧槽中逐渐抓狂~

以下示例源码 Springboot 版本均为 2.7.6

下边我们一一过下这几种玩法和原理,看看有哪些是你没用过的!话不多说,开始搞~

一、Environment

使用 Environment 方式来获取配置属性值非常简单,只要注入Environment类调用其方法getProperty(属性key)即可,但知其然知其所以然,简单了解下它的原理,因为后续的几种获取配置的方法都和它息息相关。

@Slf4j
@SpringBootTest
publicclassEnvironmentTest{

@Resource
privateEnvironmentenv;

@Test
publicvoidvar1Test(){
Stringvar1=env.getProperty("env101.var1");
log.info("Environment配置获取{}",var1);
}
}

1、什么是 Environment?

Environment 是 springboot 核心的环境配置接口,它提供了简单的方法来访问应用程序属性,包括系统属性、操作系统环境变量、命令行参数、和应用程序配置文件中定义的属性等等。

2、配置初始化

Springboot 程序启动加载流程里,会执行SpringApplication.run中的prepareEnvironment()方法进行配置的初始化,那初始化过程每一步都做了什么呢?

privateConfigurableEnvironmentprepareEnvironment(SpringApplicationRunListenerslisteners,
DefaultBootstrapContextbootstrapContext,ApplicationArgumentsapplicationArguments){
/**
*1、创建ConfigurableEnvironment对象:首先调用getOrCreateEnvironment()方法获取或创建
*ConfigurableEnvironment对象,该对象用于存储环境参数。如果已经存在ConfigurableEnvironment对象,则直接使用它;否则,根据用户的配置和默认配置创建一个新的。
*/
ConfigurableEnvironmentenvironment=getOrCreateEnvironment();
/**
*2、解析并加载用户指定的配置文件,将其作为PropertySource添加到环境对象中。该方法默认会解析application.properties和application.yml文件,并将其添加到ConfigurableEnvironment对象中。
*PropertySource或PropertySourcesPlaceholderConfigurer加载应用程序的定制化配置。
*/
configureEnvironment(environment,applicationArguments.getSourceArgs());
//3、加载所有的系统属性,并将它们添加到ConfigurableEnvironment对象中
ConfigurationPropertySources.attach(environment);
//4、通知监听器环境参数已经准备就绪
listeners.environmentPrepared(bootstrapContext,environment);
/**
*5、将默认的属性源中的所有属性值移到环境对象的队列末尾,
这样用户自定义的属性值就可以覆盖默认的属性值。这是为了避免用户无意中覆盖了SpringBoot所提供的默认属性。
*/
DefaultPropertiesPropertySource.moveToEnd(environment);
Assert.state(!environment.containsProperty("spring.main.environment-prefix"),
"Environmentprefixcannotbesetviaproperties.");
//6、将SpringBoot应用程序的属性绑定到环境对象上,以便能够正确地读取和使用这些配置属性
bindToSpringApplication(environment);
//7、如果没有自定义的环境类型,则使用EnvironmentConverter类型将环境对象转换为标准的环境类型,并添加到ConfigurableEnvironment对象中。
if(!this.isCustomEnvironment){
EnvironmentConverterenvironmentConverter=newEnvironmentConverter(getClassLoader());
environment=environmentConverter.convertEnvironmentIfNecessary(environment,deduceEnvironmentClass());
}
//8、再次加载系统配置,以防止被其他配置覆盖
ConfigurationPropertySources.attach(environment);
returnenvironment;
}

看看它的配置加载流程步骤:

创建 环境对象 ConfigurableEnvironment 用于存储环境参数;

configureEnvironment 方法加载默认的 application.properties 和 application.yml 配置文件;以及用户指定的配置文件,将其封装为 PropertySource 添加到环境对象中;

attach(): 加载所有的系统属性,并将它们添加到环境对象中;

listeners.environmentPrepared(): 发送环境参数配置已经准备就绪的监听通知;

moveToEnd(): 将 系统默认 的属性源中的所有属性值移到环境对象的队列末尾,这样用户自定义的属性值就可以覆盖默认的属性值。

bindToSpringApplication: 应用程序的属性绑定到 Bean 对象上;

attach(): 再次加载系统配置,以防止被其他配置覆盖;

上边的配置加载流程中,各种配置属性会封装成一个个抽象的数据结构 PropertySource中,这个数据结构代码格式如下,key-value形式。

publicabstractclassPropertySource{
protectedfinalStringname;//属性源名称
protectedfinalTsource;//属性源值(一个泛型,比如Map,Property)
publicStringgetName();//获取属性源的名字
publicTgetSource();//获取属性源值
publicbooleancontainsProperty(Stringname);//是否包含某个属性
publicabstractObjectgetProperty(Stringname);//得到属性名对应的属性值
}

PropertySource 有诸多的实现类用于管理应用程序的配置属性。不同的 PropertySource 实现类可以从不同的来源获取配置属性,例如文件、环境变量、命令行参数等。其中涉及到的一些实现类有:

3e922b1a-14d6-11ee-962d-dac502259ad0.png

关系图

MapPropertySource: Map 键值对的对象转换为 PropertySource 对象的适配器;

PropertiesPropertySource: Properties 对象中的所有配置属性转换为 Spring 环境中的属性值;

ResourcePropertySource: 从文件系统或者 classpath 中加载配置属性,封装成 PropertySource对象;

ServletConfigPropertySource: Servlet 配置中读取配置属性,封装成 PropertySource 对象;

ServletContextPropertySource: Servlet 上下文中读取配置属性,封装成 PropertySource 对象;

StubPropertySource: 是个空的实现类,它的作用仅仅是给 CompositePropertySource 类作为默认的父级属性源,以避免空指针异常;

CompositePropertySource: 是个复合型的实现类,内部维护了 PropertySource集合队列,可以将多个 PropertySource 对象合并;

SystemEnvironmentPropertySource: 操作系统环境变量中读取配置属性,封装成 PropertySource 对象;

上边各类配置初始化生成的 PropertySource 对象会被维护到集合队列中。

List>sources=newArrayList>()

配置初始化完毕,应用程序上下文AbstractApplicationContext会加载配置,这样程序在运行时就可以随时获取配置信息了。

privatevoidprepareContext(DefaultBootstrapContextbootstrapContext,ConfigurableApplicationContextcontext,
ConfigurableEnvironmentenvironment,SpringApplicationRunListenerslisteners,
ApplicationArgumentsapplicationArguments,BannerprintedBanner){
//应用上下文加载环境对象
context.setEnvironment(environment);
postProcessApplicationContext(context);
.........
}

3、读取配置

看明白上边配置加载的流程,其实读取配置就容易理解了,无非就是遍历队列里的PropertySource,拿属性名称name匹配对应的属性值source。

PropertyResolver是获取配置的关键类,其内部提供了操作PropertySource 队列的方法,核心方法getProperty(key)获取配置值,看了下这个类的依赖关系,发现 Environment 是它子类。

3eb975ee-14d6-11ee-962d-dac502259ad0.png

那么直接用 PropertyResolver 来获取配置属性其实也是可以的,到这我们就大致明白了 Springboot 配置的加载和读取了。

@Slf4j
@SpringBootTest
publicclassEnvironmentTest{

@Resource
privatePropertyResolverenv;

@Test
publicvoidvar1Test(){
Stringvar1=env.getProperty("env101.var1");
log.info("Environment配置获取{}",var1);
}
}

二、@Value 注解

@Value注解是Spring框架提供的用于注入配置属性值的注解,它可用于类的成员变量、方法参数和构造函数参数上,这个记住很重要!

在应用程序启动时,使用 @Value 注解的 Bean 会被实例化。所有使用了 @Value 注解的 Bean 会被加入到 PropertySourcesPlaceholderConfigurer 的后置处理器集合中。

当后置处理器开始执行时,它会读取 Bean 中所有 @Value 注解所标注的值,并通过反射将解析后的属性值赋值给标有 @Value 注解的成员变量、方法参数和构造函数参数。

需要注意,在使用 @Value 注解时需要确保注入的属性值已经加载到 Spring 容器中,否则会导致注入失败。

如何使用

在src/main/resources目录下的application.yml配置文件中添加env101.var1属性。

env101:
var1:var1-公众号:程序员小富

只要在变量上加注解 @Value("${env101.var1}")就可以了,@Value 注解会自动将配置文件中的env101.var1属性值注入到var1字段中,跑个单元测试看一下结果。

@Slf4j
@SpringBootTest
publicclassEnvVariablesTest{

@Value("${env101.var1}")
privateStringvar1;

@Test
publicvoidvar1Test(){
log.info("配置文件属性:{}",var1);
}
}

毫无悬念,成功拿到配置数据。

3eec5400-14d6-11ee-962d-dac502259ad0.png

虽然@Value注解方式使用起来很简单,如果使用不当还会遇到不少坑。

1、缺失配置

如果在代码中引用变量,配置文件中未进行配值,就会出现类似下图所示的错误。

3efd7a46-14d6-11ee-962d-dac502259ad0.png

为了避免此类错误导致服务启动异常,我们可以在引用变量的同时给它赋一个默认值,以确保即使在未正确配值的情况下,程序依然能够正常运行。

@Value("${env101.var1:我是小富}")
privateStringvar1;

2、静态变量(static)赋值

还有一种常见的使用误区,就是将 @Value 注解加到静态变量上,这样做是无法获取属性值的。静态变量是类的属性,并不属于对象的属性,而 Spring是基于对象的属性进行依赖注入的,类在应用启动时静态变量就被初始化,此时 Bean还未被实例化,因此不可能通过 @Value 注入属性值。

@Slf4j
@SpringBootTest
publicclassEnvVariablesTest{

@Value("${env101.var1}")
privatestaticStringvar1;

@Test
publicvoidvar1Test(){
log.info("配置文件属性:{}",var1);
}
}

即使 @Value 注解无法直接用在静态变量上,我们仍然可以通过获取已有 Bean实例化后的属性值,再将其赋值给静态变量来实现给静态变量赋值。

我们可以先通过 @Value 注解将属性值注入到普通 Bean中,然后在获取该 Bean对应的属性值,并将其赋值给静态变量。这样,就可以在静态变量中使用该属性值了。

@Slf4j
@SpringBootTest
publicclassEnvVariablesTest{

privatestaticStringvar3;

privatestaticStringvar4;

@Value("${env101.var3}")
publicvoidsetVar3(Stringvar3){
var3=var3;
}

EnvVariablesTest(@Value("${env101.var4}")Stringvar4){
var4=var4;
}

publicstaticStringgetVar4(){
returnvar4;
}

publicstaticStringgetVar3(){
returnvar3;
}
}

3、常量(final)赋值

@Value 注解加到final关键字上同样也无法获取属性值,因为 final 变量必须在构造方法中进行初始化,并且一旦被赋值便不能再次更改。而 @Value 注解是在 bean 实例化之后才进行属性注入的,因此无法在构造方法中初始化 final 变量。

@Slf4j
@SpringBootTest
publicclassEnvVariables2Test{

privatefinalStringvar6;

@Autowired
EnvVariables2Test(@Value("${env101.var6}")Stringvar6){

this.var6=var6;
}

/**
*@value注解final获取
*/
@Test
publicvoidvar1Test(){
log.info("final注入:{}",var6);
}
}

4、非注册的类中使用

只有标注了@Component、@Service、@Controller、@Repository 或 @Configuration 等容器管理注解的类,由 Spring 管理的 bean 中使用 @Value注解才会生效。而对于普通的POJO类,则无法使用 @Value注解进行属性注入。

/**
*@value注解非注册的类中使用
*`@Component`、`@Service`、`@Controller`、`@Repository`或`@Configuration`等
*容器管理注解的类中使用@Value注解才会生效
*/
@Data
@Slf4j
@Component
publicclassTestService{

@Value("${env101.var7}")
privateStringvar7;

publicStringgetVar7(){
returnthis.var7;
}
}

5、引用方式不对

如果我们想要获取 TestService 类中的某个变量的属性值,需要使用依赖注入的方式,而不能使用 new 的方式。通过依赖注入的方式创建 TestService 对象,Spring 会在创建对象时将对象所需的属性值注入到其中。

/**
*@value注解引用方式不对
*/
@Test
publicvoidvar7_1Test(){

TestServicetestService=newTestService();
log.info("引用方式不对注入:{}",testService.getVar7());
}

最后总结一下 @Value注解要在 Bean的生命周期内使用才能生效。

三、@ConfigurationProperties 注解

@ConfigurationProperties注解是 SpringBoot 提供的一种更加便捷来处理配置文件中的属性值的方式,可以通过自动绑定和类型转换等机制,将指定前缀的属性集合自动绑定到一个Bean对象上。

加载原理

在 Springboot 启动流程加载配置的 prepareEnvironment() 方法中,有一个重要的步骤方法 bindToSpringApplication(environment),它的作用是将配置文件中的属性值绑定到被 @ConfigurationProperties 注解标记的 Bean对象中。但此时这些对象还没有被 Spring 容器管理,因此无法完成属性的自动注入。

那么这些Bean对象又是什么时候被注册到 Spring 容器中的呢?

这就涉及到了 ConfigurationPropertiesBindingPostProcessor 类,它是 Bean后置处理器,负责扫描容器中所有被 @ConfigurationProperties 注解所标记的 Bean对象。如果找到了,则会使用 Binder 组件将外部属性的值绑定到它们身上,从而实现自动注入。

3f2651e6-14d6-11ee-962d-dac502259ad0.png

bindToSpringApplication 主要是将属性值绑定到 Bean 对象中;

ConfigurationPropertiesBindingPostProcessor 负责在 Spring 容器启动时将被注解标记的 Bean 对象注册到容器中,并完成后续的属性注入操作;

如何使用

演示使用 @ConfigurationProperties 注解,在 application.yml 配置文件中添加配置项:

env101:
var1:var1-公众号:程序员小富
var2:var2-公众号:程序员小富

创建一个 MyConf 类用于承载所有前缀为env101的配置属性。

@Data
@Configuration
@ConfigurationProperties(prefix="env101")
publicclassMyConf{

privateStringvar1;

privateStringvar2;
}

在需要使用var1、var2属性值的地方,将 MyConf 对象注入到依赖对象中即可。

@Slf4j
@SpringBootTest
publicclassConfTest{

@Resource
privateMyConfmyConf;

@Test
publicvoidmyConfTest(){
log.info("@ConfigurationProperties注解配置获取{}",JSON.toJSONString(myConf));
}
}

四、@PropertySources 注解

除了系统默认的 application.yml 或者 application.properties 文件外,我们还可能需要使用自定义的配置文件来实现更加灵活和个性化的配置。与默认的配置文件不同的是,自定义的配置文件无法被应用自动加载,需要我们手动指定加载。

@PropertySources 注解的实现原理相对简单,应用程序启动时扫描所有被该注解标注的类,获取到注解中指定自定义配置文件的路径,将指定路径下的配置文件内容加载到 Environment 中,这样可以通过 @Value 注解或 Environment.getProperty() 方法来获取其中定义的属性值了。

如何使用

在 src/main/resources/ 目录下创建自定义配置文件 xiaofu.properties,增加两个属性。

env101.var9=var9-程序员小富
env101.var10=var10-程序员小富

在需要使用自定义配置文件的类上添加 @PropertySources 注解,注解 value属性中指定自定义配置文件的路径,可以指定多个路径,用逗号隔开。

@Data
@Configuration
@PropertySources({
@PropertySource(value="classpath:xiaofu.properties",encoding="utf-8"),
@PropertySource(value="classpath:xiaofu.properties",encoding="utf-8")
})
publicclassPropertySourcesConf{

@Value("${env101.var10}")
privateStringvar10;

@Value("${env101.var9}")
privateStringvar9;
}

成功获取配置了

3f585ad8-14d6-11ee-962d-dac502259ad0.png

但是当我试图加载.yaml文件时,启动项目居然报错了,经过一番摸索我发现,@PropertySources 注解只内置了PropertySourceFactory适配器。也就是说它只能加载.properties文件。

3f732b7e-14d6-11ee-962d-dac502259ad0.png

那如果我想要加载一个.yaml类型文件,则需要自行实现yaml的适配器 YamlPropertySourceFactory。

publicclassYamlPropertySourceFactoryimplementsPropertySourceFactory{

@Override
publicPropertySourcecreatePropertySource(Stringname,EncodedResourceencodedResource)throwsIOException{
YamlPropertiesFactoryBeanfactory=newYamlPropertiesFactoryBean();
factory.setResources(encodedResource.getResource());

Propertiesproperties=factory.getObject();

returnnewPropertiesPropertySource(encodedResource.getResource().getFilename(),properties);
}
}

而在加载配置时要显示的指定使用 YamlPropertySourceFactory适配器,这样就完成了@PropertySource注解加载 yaml 文件。

@Data
@Configuration
@PropertySources({
@PropertySource(value="classpath:xiaofu.yaml",encoding="utf-8",factory=YamlPropertySourceFactory.class)
})
publicclassPropertySourcesConf2{

@Value("${env101.var10}")
privateStringvar10;

@Value("${env101.var9}")
privateStringvar9;
}

五、YamlPropertiesFactoryBean 加载 YAML 文件

我们可以使用 YamlPropertiesFactoryBean 类将 YAML 配置文件中的属性值注入到 Bean 中。

@Configuration
publicclassMyYamlConfig{

@Bean
publicstaticPropertySourcesPlaceholderConfigureryamlConfigurer(){
PropertySourcesPlaceholderConfigurerconfigurer=newPropertySourcesPlaceholderConfigurer();
YamlPropertiesFactoryBeanyaml=newYamlPropertiesFactoryBean();
yaml.setResources(newClassPathResource("xiaofu.yml"));
configurer.setProperties(Objects.requireNonNull(yaml.getObject()));
returnconfigurer;
}
}

可以通过 @Value 注解或 Environment.getProperty() 方法来获取其中定义的属性值。

@Slf4j
@SpringBootTest
publicclassYamlTest{

@Value("${env101.var11}")
privateStringvar11;

@Test
publicvoidmyYamlTest(){
log.info("Yaml配置获取{}",var11);
}
}

六、自定义读取

如果上边的几种读取配置的方式你都不喜欢,就想自己写个更流批的轮子,那也很好办。我们直接注入PropertySources获取所有属性的配置队列,你是想用注解实现还是其他什么方式,就可以为所欲为了。

@Slf4j
@SpringBootTest
publicclassCustomTest{

@Autowired
privatePropertySourcespropertySources;

@Test
publicvoidcustomTest(){
for(PropertySourcepropertySource:propertySources){
log.info("自定义获取配置获取name{},{}",propertySource.getName(),propertySource.getSource());
}
}
}

总结

我们可以通过 @Value 注解、Environment 类、@ConfigurationProperties 注解、@PropertySource 注解等方式来获取配置信息。

其中,@Value 注解适用于单个值的注入,而其他几种方式适用于批量配置的注入。不同的方式在效率、灵活性、易用性等方面存在差异,在选择配置获取方式时,还需要考虑个人编程习惯和业务需求。

如果重视代码的可读性和可维护性,则可以选择使用 @ConfigurationProperties 注解;如果更注重运行效率,则可以选择使用 Environment 类。总之,不同的场景需要选择不同的方式,以达到最优的效果。





审核编辑:刘清

声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • 适配器
    +关注

    关注

    8

    文章

    1816

    浏览量

    66911
  • YAML
    +关注

    关注

    0

    文章

    21

    浏览量

    2265
  • SpringBoot
    +关注

    关注

    0

    文章

    172

    浏览量

    105

原文标题:6种方式读取Springboot的配置

文章出处:【微信号:OSC开源社区,微信公众号:OSC开源社区】欢迎添加关注!文章转载请注明出处。

收藏 人收藏

    评论

    相关推荐

    SpringBoot配置Mybatis的2个错误和修正

    SpringBoot配置Mybatis错误
    发表于 04-19 10:31

    SpringBoot中的Druid介绍

    SpringBoot中Druid数据源配置
    发表于 05-07 09:21

    SpringBoot项目多数据源配置数据库

    SpringBoot项目多数据源配置
    发表于 06-05 09:51

    怎样去使用springboot

    怎样去使用springboot?学习springboot需要懂得哪些?
    发表于 10-25 07:13

    如何修改Servlet容器的相关配置

    Dependencies1.那么我们该如何修改Servlet容器的相关配置?1.在SpringBoot配置文件中修改server.port=8081server.servlet.
    发表于 10-27 09:10

    什么方法可以对STM32中断向量表偏移地址进行配置

    如何去重定位向量表的库函数什么方法可以对STM32中断向量表偏移地址进行配置
    发表于 11-16 08:08

    SpringBoot应用启动运行run方法

    什么时候创建嵌入式的Servlet容器工厂?什么时候获取嵌入式的Servlet容器并启动Tomcat;获取嵌入式的Servlet容器工厂:1)、SpringBoot应用启动运行run方法2
    发表于 12-20 06:16

    SpringBoot配置嵌入式Servlet

    注册Filter注册ListenerSpringBoot注册DispatcherServlet切换嵌入式Servlet容器SpringBoot默认使用Tomcat作为嵌入式的Servlet容器定制和修改Servlet容器相关配置可以
    发表于 12-20 06:19

    Springboot是如何获取自定义异常并进行返回的

    /DispatcherServlet.java的源码,然后我们来分析一下这个方法都干啥了吧那Springboot是如何选择哪一个是符合条件的自定义异常处理?如果我们定义了两个处理类,都对同一个异常进行捕获并返回不一样的信息咋办
    发表于 03-22 14:15

    深入了解SpringBoot的自动配置原理

    通过这篇文章我们来深入了解SpringBoot的自动配置原理,并分析SpringBoot是如何神不知,鬼不觉的帮我们做了那么多的事情,让我们只需要关心业务逻辑开发就可以了。
    的头像 发表于 04-07 11:22 671次阅读
    深入了解<b class='flag-5'>SpringBoot</b>的自动<b class='flag-5'>配置</b>原理

    什么是 SpringBoot

    本文从为什么要有 `SpringBoot`,以及 `SpringBoot` 到底方便在哪里开始入手,逐步分析了 `SpringBoot` 自动装配的原理,最后手写了一个简单的 `start` 组件,通过实战来体会了 `
    的头像 发表于 04-07 11:28 1009次阅读
    什么是 <b class='flag-5'>SpringBoot</b>?

    SpringBoot常用注解及使用方法1

    基于 SpringBoot 平台开发的项目数不胜数,与常规的基于`Spring`开发的项目最大的不同之处,SpringBoot 里面提供了大量的注解用于快速开发,而且非常简单,基本可以做到开箱即用! 那
    的头像 发表于 04-07 11:51 440次阅读

    SpringBoot常用注解及使用方法2

    基于 SpringBoot 平台开发的项目数不胜数,与常规的基于Spring开发的项目最大的不同之处,SpringBoot 里面提供了大量的注解用于快速开发,而且非常简单,基本可以做到开箱即用!
    的头像 发表于 04-07 11:52 399次阅读

    SpringBoot的核心注解1

    今天跟大家来探讨下SpringBoot的核心注解@SpringBootApplication以及run方法,理解下springBoot为什么不需要XML,达到零配置
    的头像 发表于 04-07 14:34 483次阅读
    <b class='flag-5'>SpringBoot</b>的核心注解1

    SpringBoot的核心注解2

    今天跟大家来探讨下SpringBoot的核心注解@SpringBootApplication以及run方法,理解下springBoot为什么不需要XML,达到零配置
    的头像 发表于 04-07 14:34 1746次阅读
    <b class='flag-5'>SpringBoot</b>的核心注解2