【SpringBoot教程】SpringBoot 配置文件详解（告别XML）

作者简介：大家好，我是撸代码的羊驼，前阿里巴巴架构师，现某互联网公司CTO

联系v：sulny_ann，加我进群，大家一起学习，一起进步，一起对抗互联网寒冬

# 学习目标

快速学会和掌握 SpringBoot 的 核心配置文件的使用。

# 基本介绍

SpringBoot 提供了丰富的 外部配置，常见的有：

• 核心配置文件

  • application.properties

  • application.yml

• 命令行参数

• OS环境变量

• Dev属性

其中核心配置文件我们并不陌生，主要以Key-Value的形式进行配置，其中属性Key主要分为两种：

• 默认属性：根据 《默认属性列表》 填写，SpringBoot将自动读取配置和进行初始化。

• 自定义属性：根据需求任意填写，但需要自行读取配置和进行初始化。

  如图所示：

# 添加默认属性

在 application.properties 添加配置如下：

①  添加数据源信息

spring.datasource.url=jdbc:oracle:thin:@localhost:1521:XEspring.datasource.username=adminspring.datasource.password=adminspring.datasource.driver-class-name=oracle.jdbc.driver.OracleDriver

# 添加自定义属性

在 application.propertis 添加配置如下：

① 添加认证信息，其中 socks.indentity.* 是自定义的属性前缀。​​​​​​​

socks.identity.number=441881199610245710socks.identity.name=sockssocks.identity.address=beijing load

② 添加随机值，其中spring.test.* 是自定义的属性前缀。​​​​​​​

spring.test.my-id1=${random.int}spring.test.my-id2=${random.int(10)}  spring.test.my-id3=${random.int[10,20]}spring.test.my-id4=${random.long}spring.test.my-name= ${random.value} spring.test.my-uuid=${random.uuid} #生成UUID

注：核心配置文件Properties和Yaml 两者都支持使用属性占位符${param}来填值，例如${random.int}就是在Environment预先定义的属性值，详情可查阅 RandomValuePropertySource。

# 读取属性

1. 使用@ConfigurationProperties 读取多个属性

使用方法：@ConfigurationProperties(prefix = "spring.datasource")

使用说明：提供 Setter方法 和 标记组件 Component​​​​​​​

@Component@ConfigurationProperties(prefix = "spring.datasource")public class MyDataSource {
    private String url;
    private String username;
    private String password;
    private String driverClassName;
    // 提供Setter 和 Getter 方法}

如何验证是否成功读取配置？答：这里可以简单做个验证，注入MyDataSource，使用Debug模式可以看到如下信息：

读取配置成功

注：嘿嘿，你现在能大概猜到为什么SpringBoot 应用能够根据默认属性来自动配置数据源了吧？因为内置的数据源类DataSourceProperties通过@ConfigurationProperties(prefix = "spring.datasource")读取到了我们在配置文件填写的数据源信息，然后通过DataSourceAutoConfiguration 创建了数据源Bean和进行了相关初始化配置。

2. 使用@Value 读取单个属性

使用方法：@Value("spring.datasource.*")

使用说明：提供 Setter方法 和 标记组件 Component

​​​​​​​

@Componentpublic class MyDataSource {
    @Value("spring.datasource.url")    private String url;
    @Value("spring.datasource.username")    private String username;
    @Value("spring.datasource.password")    private String password;
    @Value("spring.datasource.driver-class-name")    private String driverClassName;
    // 提供Setter 和 Getter 方法}

注意事项：@Value不支持注入静态变量，可间接通过Setter注入来实现。​​​​​​​

    private static String siteUrl;
    @Value("${my.url}")    public void setSiteUrl(String myUrl) {        System.out.println(myUrl);        siteUrl = myUrl;    }

3. 关于@ConfigurationProperties和@Value的区别

关于两者的简单功能对比：

特性	@ConfigurationProperties	@Value
松绑定	Yes	No
元数据（Meta-data ）	Yes	No
支持SpringEL	No	Yes

显然，前者支持松绑定的特性更强大，所以在实际开发中建议使用@ConfigurationProperties来读取自定义属性。

# 默认加载路径

SpringBoot 默认会加载这些路径加载核心配置文件，按优先级从高到低进行排列：具体规则详见 ConfigFileApplicationListener

1.工程根目录的config目录：file:./config/

2.工程根目录：file:./

3.类路径的config目录：classpath:/config/

4.类路径：classpath:/ （推荐使用）

如果存在多个配置文件，则严格按照优先级进行覆盖，最高者胜出：

举个简单的例子，例如再上述位置都有一个application.properties ，并且每个文件都写入了server.port=xx  （xx分别是9001，9002，9003，9004），在启动成功之后，最终应用的端口为：9004。图例：

工程顶层目录

如果想修改默认的加载路径 或者 调改默认的配置文件名，我们可以借助命令行参数进行指定，例如：

java -jar demo.jar --spring.config.name=app --spring.config.location=classpath:/myconfig/

注：不管 spring.config.location 配置什么值，默认总会按照 classpath:,classpath:/config,file:,file:config/

的顺序进行搜索，优先级由低到高，也就是 file:config/ 获胜。如果你指定自己的位置，它们会优先于所有的默认位置，

并使用相同的由低到高的优先级顺序。

# 使用YAML代替Properties

1. 基本介绍

YAML是JSON的一个超集，是一种可轻松定义层次结构的数据格式。

2. 为什么推荐YAML？

答：因为配置文件这东西，结构化越早接触越规范越好。这里推荐阅读阮一峰老师写的YAML语言教程 ，写的很简单明了。

3. 如何使用YAML

引入依赖：在POM文件引入snakeyaml 的依赖。

注：spring-boot-starter-xxx 会自动引入该依赖。

使用说明：直接在类路径添加application.yml 即可。

4. YAML和Properties的使用对比

例如下面这两段配置是完全等价的：

① 在application.yml 配置数据源:​​​​​​​

spring:  datasource:    url: jdbc:oracle:thin:@localhost:1521:XE    username: admin    password: admin    driver-class-name: oracle.jdbc.driver.OracleDriver

② 在application.properties 配置数据源：​​​​​​​

spring.datasource.url=jdbc:oracle:thin:@localhost:1521:XEspring.datasource.username=adminspring.datasource.password=adminspring.datasource.driver-class-name=oracle.jdbc.driver.OracleDriver

注：虽然application.yml和application.properties语法上存在差异，但实际效果相同，因为内置的YamlPropertySourceLoader 会将application.yml 的属性通过PropertySource导入到Environment上下文 。

5. Yaml支持多环境配置

在项目的实际开发中，我们往往需要根据不同的环境来加载不同的配置文件。例如生产环境，测试环境和开发环境等。此时，我们可以借助Profiles来指定加载哪些配置文件。例如：​​​​​​​

application.yml  配置如下：spring:  profiles:    active: test   # 选择加载文件application-{test}.yml
application-prod.yml  配置如下：server:  port: 9001 #生产环境端口
application-test.yml  配置如下：server:  port: 8081  #测试环境端口

温馨提示：如果spring.profiles.active指定了多个配置文件，则按顺序加载，其中最后的优先级最高，也就是最后的会覆盖前者。

# 命令行参数

使用方法：

使用Maven插件打包好项目，然后在当前路径，执行DOS命令：java -jar demo.jar --server.port=8081，在控制台可看到应用端口变成了8081。

实现原理：

默认情况下，SpringBoot会将这些命令行参数转化成一个 Property ，并将其添加到Environment上下文。

温馨提示：

由于命令行参数优先级非常之高，基本高于所有常见的外部配置，所以使用的时候要谨慎。

关闭方法：

如果想禁用命令行属性，可以设置如下操作：springApplication.setAddCommandLineProperties(false)