专栏首页小白AI.易名Spring Boot从零入门7_最新配置文件配置及优先级详细介绍

Spring Boot从零入门7_最新配置文件配置及优先级详细介绍

本文属于原创,转载注明出处,欢迎关注微信小程序小白AI博客 微信公众号小白AI或者网站 https://xiaobaiai.net 或者我的CSDN http://blog.csdn.net/freeape

0 前言

进入实际项目开发中,我们不仅仅是靠着默认的全局配置文件application.properties来配置我们的项目了,Spring Boot中的配置文件也有不少需要注意的地方,掌握后,可以方便的让我们在做项目中游刃于各种配置了,让配置一目了然,层次清楚,模块清晰,写成总结,另外方便以后参考查阅。该文章的内容是最新的配置文件介绍内容,全部参考最新的官方文档所写,截至2019年11月21日,此时Spring是5.2.1版本,Spring Boot是2.2.1版本。

1 我们需要了解

Spring Boot提供了一个spring-boot-devtoolsjar包,提供了一些方便程序开发的功能,主要是监控程序的变化,然后进行自动重新启动。使用spring-boot-devtools需要在pom.xml中添加依赖项,同时需要设置<optional>true</optional>spring-boot-devtools默认将只在开发环境生效,通过Spring Boot插件打包时默认是不会包含spring-boot-devtools

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <optional>true</optional>
</dependency>

2 简介和全局概述

创建一个Spring Boot项目后,会在src/main/resources目录下默认生成一个全局配置文件application.properties,不过里面啥内容也没有。Spring Boot已经将所有默认配置参数都自动配置好了(https://docs.spring.io/spring-boot/docs/current/reference/html/appendix-application-properties.html),如果我们在外部配置文件中修改配置,则默认配置参数就会被修改(Externalized Configuration,配置外部化),配置外部化的方式有好几种,可以使用属性文件(properties file)、YAML文件、环境变量和命令行参数将配置外部化,下面内容会详细介绍。

比如配置文件可以是application.properties或者是application.yml,都可以配置,只是里面的配置语法不一样而已,yml格式层次相比properties格式要分明些。

.properties写法:

server.port = 9090
spring.application.name = demoservice

.yml写法:

spring:
    application:
        name: demoservice
   server:
port: 9090

注意:yml格式中一定不要用制表符tab,冒号和值之间一定要有空格。

Spring Boot对参数的重写(覆盖)有一个顺序,这是我们需要注意的,这里概况如下:

  1. 当使用了Devtools时,$HOME/.config/spring-boot文件夹中的Devtools全局设置属性
  2. @TestPropertySource针对对测试的注解
  3. 测试的properties。在@SpringBootTest和测试注释中提供,用于测试应用程序的特定部分
  4. 命令行参数
  5. 来自SPRING_APPLICATION_JSON(内嵌在环境变量或系统属性中的JSON)的属性
  6. ServletConfig初始化参数
  7. ServletContext初始化参数
  8. JNDI属性:java:comp/env
  9. Java系统属性: System.getProperties()
  10. 操作系统环境变量
  11. RandomValuePropertySource,其属性仅在random.*
  12. 打包jar之外的特定于概要文件的应用程序属性(如application-{profile}.properties和对应的YAML变量)
  13. 打包在jar中的特定于概要文件的应用程序属性(如application-{profile}.properties和YAML变量)
  14. 打包jar之外的应用程序属性(application.properties和YAML变量)
  15. 打包在jar中的应用程序属性(application.properties和YAML变量)
  16. @Configuration类上的@PropertySource注解
  17. 默认属性(通过设置SpringApplication.setDefaultProperties指定)

举一个具体的例子来说明上述的顺序是如何生效的:

import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*;

@Component
public class MyBean {

    @Value("${name}")
    private String name;

    // ...
}

比如在应用程序类路径(例如,打包在jar内)上,可以有一个application.properties文件,该文件为name属性设置了默认属性值。在新环境中运行时,可以在jar外部提供application.properties文件,该文件覆盖会覆盖在jar内application.properties。又如对于一次性测试,可以使用特定的命令行开关启动(例如,java -jar app.jar --name="Spring")也可以覆盖name属性值。又如可以JSON格式环境变量$ java -Dspring.application.json='{"name":"test"}' -jar myapp.jar来覆盖。其他方式就不一一举例了。

3 配置参数

3.1 参数设置及加载目录的顺序及作用优先级

参数设置有两种方式语法,一个properties,一个是ymlSpringApplicationapplication.properties文件加载以下位置的属性,并将它们添加到Spring环境中。

  1. 当前项目目录的config子目录
  2. 当前项目根目录
  3. classpath设定目录下的config子目录
  4. classpath设定目录下

上述列表按优先级排序(在列表中较高位置定义的属性将覆盖在较低位置定义的属性,如1中设置的属性值将覆盖2中同属性的属性值)。

注意:用maven构建项目时,src/main/resources目录就是默认的classpath

另外这里说下yml的注意点和特殊用法。

  • yml格式中一定不要用制表符tab,冒号和值之间一定要有空格 一定要有空格 一定要有空格
  • yml的双引号不会转义字符串里面的特殊字符,特殊字符按本身功能输出,比如
  • yml的单引号会转义字符串里面的特殊字符,输出原来的字符
# 下面会输出得到hello换行xiaobaiai.net
name: "hello\nxiaobaiai.net"
# 下面会输出得到hello\nxiaobaiai.net
name: 'hello\nxiaobaiai.net'
  • yml支持对象、数组、纯量(字符串、布尔值true/false、整数、浮点数、null、时间、日期new Date('1976-07-31'))
# 对象行内写法
students: { name: Steve, age: 22 }
# 数组行内写法
animal: [Cat, Dog]
# 或者数组非行内写法
animal:
    - Cat
    - Dog

3.2 生成配置参数随机值

生成配置参数随机值在测试或者某些场景下是非常有用的。

如我们配置:

#random int
app.location-x=${random.int}
app.location-y=${random.int}

#random int with max
app.user-age=${random.int(100)}

#random int range
app.max-users=${random.int[1,10000]}

#random long with max
app.refresh-rate-milli=${random.long(1000000)}

#random long range
app.initial-delay-milli=${random.long[100,90000000000000000]}

#random 32 bytes
app.user-password=${random.value}

#random uuid. Uses java.util.UUID.randomUUID()
app.instance-id=${random.uuid}

最后输出:locationX=-449689812, locationY=-2048116572, userAge=88, maxUsers=8927, refreshRateMilli=418859, initialDelayMilli=12542150790115755, userPassword=95ea8b43fd16dc26aad0030c1340e723, instanceId=bd252902-54e9-47b3-bebf-a81b1300ff69

3.3 参数间引用(占位符)

在配置参数中可以通过占位符来实现引用之前定义的参数值,如:

app.name=MyApp
app.description=${app.name} is a Spring Boot application

有些人喜欢(例如)使用--port=9000而不是--server.port=9000在命令行上设置配置属性。可以通过在application.properties中使用占位符来启用此行为:

server.port=${port:8080}

注意:如果继承自spring-boot-starter-parentPOM,则maven资源插件的默认筛选标记已从${*}更改为@(即,@maven.token@而不是${maven.token}),以防止与spring样式占位符冲突。如果直接为application.properties启用了Maven筛选,则可能还需要将默认筛选标记更改为其他分隔符,而不是@

3.4 自定义配置文件

3.4.1 方式一

如果不喜欢将application.properties作为配置文件名,可以通过指定spring.config.name环境属性切换到另一个文件名。还可以使用spring.config.location环境属性(目录位置或文件路径的逗号分隔列表)指定配置文件位置。以下示例演示如何指定其他文件名:

$ java -jar myproject.jar --spring.config.name=myConfig

下面的示例演示如何指定两个位置:

$ java -jar myproject.jar --spring.config.location=classpath:/default.properties,classpath:/override.properties

如果spring.config.location包含目录(而不是文件),则需要以/结尾,并且,运行的时候,在加载配置之前,应该附加从spring.config.name配置的名称或者默认配置名称。默认不配置spring.config.location则搜索配置文件顺序为:

file:./config/
file:./
classpath:/config/
classpath:/

使用时配置自定义配置位置时spring.config.location,它们会替换默认位置。例如,如果spring.config.location配置了值classpath:/custom-config/,file:./custom-config/,则搜索顺序将变为:

file:./custom-config/
classpath:custom-config/

当使用配置自定义配置位置时spring.config.additional-location,除了额外配置路径外,还会使用默认位置。在默认位置之前搜索其他位置。

注意:在编程环境中,直接去application.properties中设置spring.config.name是无法生效的,只有在命令行或者设置环境变量export SPRING_CONFIG_NAME=myConfig,或者在代码中去手动编码导入指定路径中的配置文件。

3.4.2 方式二

直接通过编码加载指定配置文件去实现,这种方式其实跟后面小节讲到的自定义属性是相通的,只多了一个指定文件名的注解,更详细的可以看后面操作。比如我们创建test.properties,路径跟也放在src/main/resources下面:

my.app.name=hello
my.app.func=test

然后新建一个参数Bean:

@Configuration
@ConfigurationProperties(prefix="my.app")
@PropertySource("classpath:test.properties")
public class ConfigTestBean {
    private String name;
    private String func;
    // 省略getter和setter
}

这样就Ok了,怎么去验证可以看自定义配置参数小节。

3.5 命令行配置参数

默认情况下,SpringApplication将任何命令行选项参数(即以--开头的参数,例如--server.port=9000)转换为属性,并将它们添加到Spring环境中。如前所述,命令行属性顺序排在第四,始终优先于其下面属性源。

如果不希望命令行属性添加到Spring环境中,可以在程序中使用SpringApplication.setAddCommandLineProperties(false)禁用它们。

3.6 特定于配置文件的属性(激活profile)

除了application.properties文件外,还可以使用以下命名约定定义特定于配置文件的属性:application-{profile}.properties。环境有一组默认配置文件(默认情况下profile为default,即application-default.properties),如果未设置活动配置文件,则使用默认的application-default.properties文件,加载顺序和优先级还是与application.properties一样的。Spring可使用Profile决定程序在不同环境下执行情况,包含配置、加载Bean、依赖等,Spring的Profile一般项目包含:dev(开发), test(单元测试), qa(集成测试), prod(生产环境)。同样地,Maven也有Profile配置,可在构建过程中针对不同的Profile环境执行不同的操作,包含配置、依赖、行为等,每个Profile中可设置:id(唯一标识), properties(配置属性), activation(自动触发的逻辑条件), dependencies(依赖)等。

说到这里,如何激活profile呢?下面介绍三种方式。

注意:application-{profile}.properties的重写优先级是要高于application.properties的,这个跟配置文件加载顺序没有关系。另外创建application-{profile}.yml文件跟properties是一样的。

3.6.1 方式一

在配置文件中设置,这种方式不灵活,实际开发中不不太会用到

spring.profiles.active=test

3.6.2 方式二

使用占位符,在打包时替换,以Maven为例

第一步在properties中添加(package.target是自定义的参数):

spring.profiles.active=@package.target@

第二步在pom.xml中增加不同环境打包的配置:

<!-- 与Maven build标记并列 -->
<profiles>
    <!-- 开发环境 -->
    <profile>
        <id>dev</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <properties>
            <package.target>dev</package.target>
        </properties>
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-tomcat</artifactId>
            </dependency>
            <dependency>
                <groupId>org.apache.tomcat</groupId>
                <artifactId>tomcat-jdbc</artifactId>
            </dependency>
        </dependencies>
    </profile>
    <!-- 生产环境 -->
    <profile>
        <id>prod</id>
        <properties>
            <package.target>prod</package.target>
        </properties>
    </profile>
</profiles>

从上面的配置可以看出,Maven的Profile配置了两个:dev和prod,并且在dev中使用了内嵌Tomcat,而 prod 中没有(这种配置场景如生产环境下使用外部Tomcat,开发时使用内部Tomcat)。

第三步再添加资源过滤实现在构建时修改以“@xxx@”表示的属性,利用Maven的resources插件:

...

<plugins>
    <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
    </plugin>
</plugins>

<!-- Maven build标记内 -->
<resources>
    <!-- 不加该resource也可以 -->
    <resource>
        <directory>src/main/resources</directory>
        <excludes>
            <!-- 排除掉src/main/resources下的所有application*.properties文件 -->
            <exclude>application*.properties</exclude>
        </excludes>
    </resource>
    <resource>
        <!-- 指定要处理的资源目录 -->
        <directory>src/main/resources</directory>
        <!-- 是否替换@xx@表示的maven properties属性值 -->
        <filtering>true</filtering>
        <includes>
            <!-- 将文件内容的“@xx@”替换为相应的变量,即package.target -->
            <include>application-${package.target}.properties</include>
        </includes>
    </resource>
</resources>

第四步就是编译打包了:

# 根据Maven Profile的 dev 构建环境包
$ mvn clean package -Dmaven.test.skip=true -Pdev

3.6.3 方式三

通过设置系统环境变量:

export SPRING_PROFILES_ACTIVE=dev

3.6.4 其他方式

Java命令行设定方式:

# 方式一
$ java -jar app.jar --spring.profiles.active=dev
# 方式二
$ java -jar -Dspring.profiles.active=dev demo-0.0.1-SNAPSHOT.jar

注解方式(@ActiveProfiles是Spring Boot的Test starter提供的注解,在单元测试中就比较有用了,只能在/src/test/java中使用):

@ActiveProfiles("dev")

3.6.5 YML特殊方式

YAML文件实际上可以是由---行分隔的一系列文档,每个文档被分别解析为一个展开的配置映射。然后激活dev还是production的方式同样的也有指定环境变量或者命令行方式之类的。

# 通用属性
server:
    port: 9000
---
# dev环境下配置
spring:
    profiles: dev
server:
    port: 9001

---
# production生产环境下配置
spring:
    profiles: production
server:
    port: 0

3.7 自定义属性

Spring已经为我们提供很多的默认参数,不过我们也可以创建自己的配置参数。比如我们在application.properties中创建下面的自定义属性:

#random int
app.location-x=${random.int}
app.location-y=${random.int}

#random int with max
app.user-age=${random.int(100)}

#random int range
app.max-users=${random.int[1,10000]}

#random long with max
app.refresh-rate-milli=${random.long(1000000)}

#random long range
app.initial-delay-milli=${random.long[100,90000000000000000]}

#random 32 bytes
app.user-password=${random.value}

#random uuid. Uses java.util.UUID.randomUUID()
app.instance-id=${random.uuid}

然后创建对应的Java参数组件MyAppProperties.java

@Component
@ConfigurationProperties("app")
	public class MyAppProperties {
	private int locationX;
	private int locationY;
	private int userAge;
	private int maxUsers;
	private long refreshRateMilli;
	private long initialDelayMilli;
	private String userPassword;
	private UUID instanceId;
	
	public int getLocationX() {
		return locationX;
	}
	public void setLocationX(int locationX) {
		this.locationX = locationX;
	}
	public int getLocationY() {
		return locationY;
	}
	public void setLocationY(int locationY) {
		this.locationY = locationY;
	}
	public int getUserAge() {
		return userAge;
	}
	public void setUserAge(int userAge) {
		this.userAge = userAge;
	}
	public int getMaxUsers() {
		return maxUsers;
	}
	public void setMaxUsers(int maxUsers) {
		this.maxUsers = maxUsers;
	}
	public long getRefreshRateMilli() {
		return refreshRateMilli;
	}
	public void setRefreshRateMilli(long refreshRateMilli) {
		this.refreshRateMilli = refreshRateMilli;
	}
	public long getInitialDelayMilli() {
		return initialDelayMilli;
	}
	public void setInitialDelayMilli(long initialDelayMilli) {
		this.initialDelayMilli = initialDelayMilli;
	}
	public String getUserPassword() {
		return userPassword;
	}
	public void setUserPassword(String userPassword) {
		this.userPassword = userPassword;
	}
	public UUID getInstanceId() {
		return instanceId;
	}
	public void setInstanceId(UUID instanceId) {
		this.instanceId = instanceId;
	}
	
	@Override
	public String toString() {
		return "MyAppProperties [locationX=" + locationX + ", locationY=" + locationY + ", userAge=" + userAge
				+ ", maxUsers=" + maxUsers + ", refreshRateMilli=" + refreshRateMilli + ", initialDelayMilli="
				+ initialDelayMilli + ", userPassword=" + userPassword + ", instanceId=" + instanceId + "]";
	}
}

@ConfigurationProperties 注解向Spring Boot声明该类中的所有属性和配置文件中相关的配置进行绑定。prefix = "app"prefix=可省略) : 声明配置前缀,将该前缀下的所有属性进行映射。@Component 或者@Configuration:将该组件加入Spring Boot容器,只有这个组件是容器中的组件,配置才生效。

提示:也可以通过 @Value("${key}") 读取配置文件中的属性,key = properties文件等号左边的key部分。在我们定义的 Java 参数组件中,还可以对具体的参数进行注解断言,如@Email加到邮件的变量上,则如果注入的不是一个合法的邮件地址则会抛出异常。这类注解还有@AssertFalse 校验false、@AssertTrue 校验true、@DecimalMax(value=10,inclusive=true) 小于等于10,inclusive=true,是小于等于、@DecimalMin(value=,inclusive=)@Max(value=) 小于等于value、@Min(value=) 大于等于value、@Past 检查日期、@Pattern(regex=,flag=) 正则、@Validate 对po实体类进行校验等。

最后还需要加入依赖spring-boot-configuration-processor

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-test</artifactId>
	<scope>test</scope>
	<exclusions>
		<exclusion>
			<groupId>org.junit.vintage</groupId>
			<artifactId>junit-vintage-engine</artifactId>
		</exclusion>
	</exclusions>
</dependency>
<!-- 加入spring-boot-configuration-processor -->
<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-configuration-processor</artifactId>
	<optional>true</optional>
</dependency>

校验我们自定义的配置:

@SpringBootApplication
public class Test07HelloworldApplication {

	public static void main(String[] args) {
		ConfigurableApplicationContext context = SpringApplication.run(Test07HelloworldApplication.class, args);
		MyAppProperties bean = context.getBean(MyAppProperties.class);
		System.out.println(bean.toString());
	}
}

// output
// MyAppProperties [locationX=1329054364, locationY=1100464591, userAge=99, maxUsers=8007, refreshRateMilli=733281, initialDelayMilli=54489880705550952, userPassword=76aebd15270f7065adf3d31b5a790829, instanceId=681ed3a4-a561-460c-b826-58229c31b055]

4 总结

上述的内容大部分经过实际Demo验证,示例代码可以在https://github.com/yicm/SpringBootExamples上找到。配置文件这一章细节内容比较多,但是我们把握几个点就好了,这个总结下:

  • Spring Boot为我们提供了大量的默认配置,我们可以重写这些配置参数的值,并提供了多种方式去重写(覆盖),且重写方式之间是有优先级的
  • Spring Boot应用可以在不同的位置加载配置文件application.properties(yml),并且这些位置是有顺序、优先级的
  • Spring Boot的参数之间可以通过占位符引用,而且还可以通过占位符实现命令行参数名字的简化
  • Spring Boot可以支持自定义参数
  • Spring Boot可以支持自定义配置文件名
  • Spring Boot可以支持多配置文件的切换,通过application-{profile}.properties(yml)激活profile,且有多种方式去激活profile

如果你知道了上述总结的具体内容,那么这一博文你也差不多都了解了。

5 参考资料

  • https://docs.spring.io/spring-boot/docs/current/reference/html/appendix-application-properties.html
  • https://docs.spring.io/spring-boot/docs/current/reference/html/spring-boot-features.html#boot-features-external-config-yaml
  • https://docs.spring.io/spring-boot/docs/current/reference/html/spring-boot-features.html#boot-features-external-config
  • https://docs.spring.io/spring-boot/docs/2.2.1.RELEASE/api//org/springframework/boot/SpringApplication.html
  • https://docs.spring.io/spring/docs/5.2.1.RELEASE/javadoc-api/org/springframework/test/context/TestPropertySource.html
  • https://docs.spring.io/spring-boot/docs/current/reference/html/spring-boot-features.html#boot-features-testing-spring-boot-applications-testing-autoconfigured-tests
  • http://www.ruanyifeng.com/blog/2016/07/yaml.html
  • https://yaml.org/spec/1.2/spec.html
  • https://segmentfault.com/a/1190000011770028

本文分享自微信公众号 - 别打名名(biedamingming),作者:别打名名

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2019-11-22

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • Spring Boot从零入门3_创建Hello World及项目剖析

    上一篇我们讲述了Spring boot的几个核心模块,知道了Spring boot是如何减少组件依赖和简化繁杂的配置的,以及讲述了Spring boot减少组件...

    别打名名
  • Spring Boot Kafka概览、配置及优雅地实现发布订阅

    本文属于翻译,转载注明出处,欢迎关注微信小程序小白AI博客 微信公众号小白AI或者网站 https://xiaobaiai.net

    别打名名
  • 3天学会Jenkins_10_gitlab or github代码提交后自动构建1

    转载注明出处,欢迎关注微信小程序小白AI博客 微信公众号小白AI或者网站 https://xiaobaiai.net或者我的CSDN https://blog....

    别打名名
  • Spring Boot系列之-logging

    二. 更改Spring Boot日志组件为Log4j(注:Spring Boot仅仅支持Log4j 2.x版本):

    2Simple
  • 1. spring-boot框架初始

    本来想从零开始,但是发现简书已有很多文章,在这里就不赘述了,查看spring-boot专题了解更多内容。

    MasterVin
  • Python渗透测试工具都有哪些?

    如果你热爱漏洞研究、逆向工程或者渗透测试,我强烈推荐你使用 Python 作为编程语言。它包含大量实用的库和工具,本文会列举其中部分精华。 网络 Scapy, ...

    FB客服
  • 13条Python2.x和3.x的区别?

    从今天开始,小明将和你一起过一下,那些在面试「Python开发」岗位时面试官喜欢问的问题。内容基础,但是你不一定会噢。

    py3study
  • Python从入门到熟练(3):第一个程序

    建议:新程序使用Python 3.x ,维护Python 2.x旧代码做好向Python 3.x的迁移准备

    用户3578099
  • 再聊聊Python中文社区的翻译

    在写《学习Python,怎能不懂点PEP呢?》的时候,我已经发现国内的Python翻译环境不容乐观。这个结论可能不对,毕竟这几年Python大热,或许有不少优秀...

    Python猫
  • 每个Python程序员都应该知道的10个缩写

    对于许多刚开始学习代码的人来说,Python已经成为最佳的选择。它的语法非常直观,并且支持灵活的动态类型。另外,它是一种解释性语言,可以将交互式控制台用于学习。...

    小白学视觉

扫码关注云+社区

领取腾讯云代金券