《【源码解析】凭什么？spring boot 一个 jar 就能开发 web 项目》 中有读者反应：
部署后运维很不方便，比较修改一个 ip 配置，需要重新打包。
这一点我是深有体会，17 年自学，并很大胆的直接在生产环境用的时候，我都是让产品经理（此时他充当我们的运维，嘿嘿）用压缩软件打开 jar，然后复制出配置，修改完之后再替换回去。为什么我这么大胆，因为当时才入行一年，而且觉得有架构师兜底，我就奔放了。你是不知道，当时负责这个项目的开发（c#开发）一开始不想用 springboot 的。
不过如今看到这个问题，我有点震惊，都 9102 年了，竟然还担心这样的问题。我想说，哥们，这真的不是事儿。springboot 早就提供了方法来解决这个问题。
springboot 有很多生产特性，可以在生产环境中使用时更加方便。其中外部化配置基本都会用到。
spring boot 允许外部化配置，以便相同的应用在不同的环境中工作。
属性值可以在 spring 环境中使用 @value 或 @configurationproperties 使用。
此次参考的版本是 springboot-2.2.0.release
外部化配置的优先级顺序如下：
我要评论$home/.config/spring-boot@testpropertysourceproperties 属性：在 @springboottest 和 用来测试特定片段的测试注解spring_application_json 中的属性：内嵌在环境变量或系统属性中的 jsonservletconfig 初始化参数servletcontext 初始化参数java:comp/env 中的 jndi 属性system.getproperties()randomvaluepropertysource）：random.*属性application-{profile}.propertiesapplication-{profile}.propertiesapplication.propertiesapplication.properties@propertysource注解：用于 @configuration 类上springapplication.setdefaultproperties 指定注意：以上用 properties 文件的地方也可用 yml文件
my.uuid=${random.uuid}
java -jar -ddemo=vm demo.jar --demo=arg
system#getproperty 获取environment#getproperty 获取，若通过此方法获取不到，会获取 vm 同名参数public static void main(string[] args) {
configurableapplicationcontext context = springapplication.run(argapplication.class, args);
logger.info("----------------");
/* 打印 arg 参数 */
arrays.stream(args)
.foreach(
arg -> {
logger.info("arg:{}", arg);
});
/* 命令行传参 demo */
logger.info("system#getproperty:{}", system.getproperty("demo"));
logger.info("environment#getproperty:{}", context.getenvironment().getproperty("demo"));
}
输入命令
java -jar -ddemo=vm arg-0.0.1-snapshot.jar aaa bbb ccc --demo=arg
效果如下：
---------------- arg:aaa arg:bbb arg:ccc arg:--demo=arg system#getproperty:vm environment#getproperty:arg
而如果执行命令是：
java -jar -ddemo=vm arg-0.0.1-snapshot.jar aaa bbb ccc
结果如下：
arg:aaa arg:bbb arg:ccc system#getproperty:vm environment#getproperty:vm
如果执行命令是：
java -jar arg-0.0.1-snapshot.jar aaa bbb ccc --demo=arg
结果如下：
arg:aaa arg:bbb arg:ccc arg:--demo=arg system#getproperty:null environment#getproperty:arg
优先级：
如果定义了 spring.config.location，如：classpath:/custom-config/,file:./customr-config/，优先级如下：
如果指定了 spring.config.additional-location，会先加载 additional 配置 如：spring.config.additional-location=classpath:/custom-config/,file:./customr-config/，优先级如下：
默认的 profile 是 default，当没有指定spring.profiles.active 属性时，默认会加载application-default.properties 文件。指定 profiles 文件的加载顺序与上述不指定 profiles 文件的加载一致。指定 profile 文件的属性始终覆盖未指定文件的属性。如：spring.profiles.active=dev，则 application-dev.properties文件内的属性会覆盖 application.properties 内的同名属性。
注意：如果在
spring.config.location属性中指定了文件，则此文件对应的特定 profiles 类文件不起作用。如果想要起作用，在spring.config.location中使用文件夹。
配置文件中可以引用之前定义的值，如下：
app.name=myapp
app.description=${app.name} is a spring boot application.
可以用此特性创建一些已存在的 spring boot 配置的较短、易于使用的变量。如下：
# nacos 配置示例
spring:
cloud:
nacos:
config:
server-addr: 127.0.0.1:8848
namespace: d9a39d78-xxxxxxxx-ea4f282e9d99
discovery:
server-addr: 127.0.0.1:8848
namespace: d9a39d78-xxxxxxxx-ea4f282e9d99
# discovery 配置示例
nacos:
plugin:
namespace: d9a39d78-xxxxxxxx-ea4f282e9d99
可改为如下配置
spring:
cloud:
nacos:
config:
server-addr: ${app.server-addr}
namespace: ${app.namespace}
discovery:
server-addr: ${app.server-addr}
namespace: ${app.namespace}
# discovery 配置示例
nacos:
plugin:
namespace: ${app.namespace}
app:
server-addr: 127.0.0.1:8848
namespace: d9a39d78-xxxxxxxx-ea4f282e9d99
然后在命令行可以直接通过 -dapp.namespace 或 --app.namespace 来传参，会方便很多。特别是在多个地方用到同一个属性的时候。
spring boot 不支持属性加密，但提供钩子节点修改配置属性。environmentpostprocessor 接口允许在应用启动前操作 environment 。
yaml 文件使用的时候非常直观、方便。而且在 spring boot 中做了处理，获取 yaml 和 properties 文件中的属性基本是一样的操作。
通过 spring.profiles 指示何时使用对应的配置，使用 ---进行配置分隔
# application.yml server: address: 192.168.1.100 --- spring: profiles: development server: address: 127.0.0.1 --- spring: profiles: production & eu-central server: address: 192.168.1.120
用 @propertysource 不能加载 yaml 文件，这种情况下只能使用 properties 文件。
在特定 profile 的 yaml 文件中使用多 profile 配置，会有意料之外的情况：
# application-dev.yml
server:
port: 8000
---
spring:
profiles: "!test"
security:
user:
password: "secret"
当运行时指定 --spring.profiles.active=dev ，启用 dev profile，其它的 profile 会忽略。也就是此例中 spring.security.user.password 属性会失效。
因此，不要在指定 profile 的 yaml 文件中使用多种 profile 配置。
通过 @configurationproperties 注解将属性（properties、yml 文件、环境变量等）绑定到类对象中。与自动配置类类似。
@configurationproperties("acme")
public class acmeproperties{
private boolean enabled;
private inetaddress remoteaddress;
private final security security = new security();
// getter and setter
public static class security{
private string username;
private string password;
private list<string> roles = new arraylist<>(collections.singleton("user"));
// getter and setter
}
}
这种安排依赖于默认的无参构造器，getter 和 setter 通常是必需的，因为绑定就像 spring mvc 一样是通过标准的 java beans 属性描述符进行的。在下列情况下，可省略 setter：
- maps：只要被初始化后，getter 必须而 setter 不必须，binder 可以对它们进行修改
- collections 和 数组：可以通过索引或逗号分隔的值来设定属性。后者必须有 setter 方法。建议对于这种情况一直加上 setter。如果初始化了一个 collection，确保它不是不可变类型。
- 如果初始化了嵌套的 pojo 属性（如上例中的 security），setter 不是必须的。如果需要 binder 通过其默认构造器动态创建实例，则需要 setter
注意：如果使用 lombok 生成 getter 和 setter，确保不会生成任何特定的构造器，不然容器会自动使用它来实例化对象。
最后，只有标准 java bean 属性可以这样绑定属性，静态属性不支持。
上述示例可以改成如下：
@constructorbinding
@configurationproperties("acme")
public class acmeproperties{
private final boolean enabled;
private final inetaddress remoteaddress;
private final security security;
public acmeproperties(boolean enabled, inetaddress remoteaddress, security security){
this.enabled = enabled;
this.remoteaddress = remoteaddress;
this.security = security;
}
// getter and setter
public static class security{
private final string username;
private final string password;
private final list<string> roles;
public security(string username, string password, @defaultvalue("user") list<string> roles){
this.username = username;
this.password = password;
this.roles = roles;
}
// getter and setter
}
}
@constructorbinding 注解表示使用构造函数绑定属性值。这意味着 binder 将期望找到一个包含待绑定参数的构造器。
@constructorbinding 类的嵌套成员也将通过构造函数绑定属性值。
可以使用 @defaultvalue 指定默认值，转换服务将字符串值强转为缺少属性的目标类型。
要使用构造绑定，类必须允许使用
@enableconfigurationproperties或 配置属性扫描方式。不能对由常规 spring 机制创建的 bean 使用构造函数绑定。如：@component bean、通过@bean 方法创建的 bean 或使用@import 加载的 bean
如果类中有多个构造器，可以直接将
@constructorbinding注解使用在要绑定的构造器上。
@configurationproperties 注解类型spring boot 提供了一个基础设施来绑定这些类型并将它们自动注册为 bean。
如果应用程序中使用@springbootsapplication，用@configurationproperties注解的类将被自动扫描并注册为 bean。默认情况下，将从声明此注解的类的包中进行扫描。如果要扫描特定的包，可以对 ·@springbootsapplication注解的类显式使用@configurationpropertiescan注解，如下例所示：
@springbootapplication
@configurationpropertiesscan({ "com.example.app", "org.acme.another" })
public class myapplication {
}
有时，用
@configurationproperties注释的类可能不适合扫描，例如，如果正在开发自己的自动配置，在这些情况下，可以在任何@configuration 类上指定要处理的类型列表，如下例所示：
@configuration(proxybeanmethods = false) @enableconfigurationproperties(acmeproperties.class)
public class myconfiguration { }
注意：当使用配置属性扫描或通过@enableconfigurationproperties 注册@configurationproperties bean 时，bean 有一个常规名称：
<prefix>-<fqn>，其中<prefix>是@configurationproperties注解中指定的环境 key 前缀，<fqn>是 bean 的完全限定名。如果注解没有提供任何前缀，则只使用 bean 的完全限定名。
上例中 bean name 是acme-com.example.acmeproperties。
@configurationproperties 注解类型这种类型的配置在 springapplication 外部 yaml 配置中特别适用，如下例所示：
# application.yml
acme:
remote-address: 192.168.1.1
security:
username: admin
roles:
- user
- admin
@configurationproperties bean 可以像其它 bean 一样注入使用。如下：
@service
public class myservice{
private final acmeproperties properties;
@autowired
public myservice(acmeproperties properties){
this.properties = properties;
}
// ...
}
使用
@configurationproperties还可以生成元数据文件，ide 可以使用这些文件提供代码自动完成功能。
除了可以在 类 上使用 @configurationproperties 注解，还可以在 public @bean 方法上使用它。如果要将属性绑定到不在控制范围内的第三方组件，那么这样做特别有用。
要从 environment 属性配置 bean，将 @configurationproperties 添加到其 bean 注册中，如下例所示：
@configurationproperties(prefix = "another")
@bean
public anothercomponent anothercomponent() {
//...
}
用
another前缀定义的任何 javabean 属性都映射到anothercomponentbean 上，映射方式类似于前面的 acmeproperties 示例。
spring boot 使用一些宽松的规则将
environment属性绑定到@configurationpropertiesbean，因此环境属性名和 bean 属性名之间不需要完全匹配。常见的包括短划线分隔的环境属性（例如，context-path绑定到contextpath）和大写的环境属性（例如，port绑定到port）。
@configurationproperties(prefix="acme.my-project.person")
public class ownerproperties {
private string firstname;
public string getfirstname() {
return this.firstname;
}
public void setfirstname(string firstname) {
this.firstname = firstname;
}
}
对于以上 java bean，可以使用以下属性
注意：注解的前缀值必须是短横线 (小写，用-分隔，如：acme.my-project.person)。
建议：如果可能的话，将属性存储为小写的短横线格式，例如：my.property-name=acme。
在绑定到 map 属性时，如果 key 包含除小写字母-数字字符或 - 之外的任何内容，则需要使用括号符号，以便保留原始值。如果 key 没有被[]包围，则删除任何不是字母数字或 -的字符。
acme:
map:
"[/key1]": value1
"[/key2]": value2
/key3: value3
上面的属性将绑定到 map 的这些 key 中：/key1、/key2、key3
当在多个位置配置 list 时，通过替换（而非添加）整个 list 来覆盖。
@configurationproperties("acme")
public class acmeproperties {
private final list<mypojo> list = new arraylist<>();
public list<mypojo> getlist() { return this.list;
}
}
acme:
list:
- name: my name
description: my description
---
spring:
profiles: dev
acme:
list:
- name: my another name
当启用 dev 配置时，acmeproperties.list 中值包含一个 mypojo 对象（name 为my another name），不是添加操作，而是覆盖操作。
当一个
list在多个 profiles 中定义时，最高优先级的被使用。
对于 map 属性，可以使用从多个属性源获取属性值进行绑定。但是，对于多个源中的同一属性，将使用优先级最高的属性。
@configurationproperties("acme")
public class acmeproperties {
private final map<string, mypojo> map = new hashmap<>();
public map<string, mypojo> getmap() {
return this.map;
}
}
acme:
map:
key1:
name: my name 1
description: my description 1
---
spring:
profiles: dev
acme:
map:
key1:
name: dev name 1
key2:
name: dev name 2
description: dev description 2
当 dev 配置启用时，acmeproperties.map 中包含两个键值对。key1 中 pojo name 为 dev name 1，description 为 my description 1；key2 中 pojo name 为 dev name 2，description 为 dev description 2。
不同属性源的配置进行了合并
以上合并规则适用于所有的属性源
spring boot 试图在绑定到
@configurationpropertiesbean 时将外部应用程序属性强转为正确的类型。如果需要自定义类型转换，可以提供conversionservicebean（带有名为conversionservice的 bean）或自定义属性编辑器（通过customeditorconfigurerbean）或自定义converters（使用 bean 定义注解@configurationpropertiesbinding）。
注意：由于此 bean 在应用程序生命周期的早期被请求，请确保限制
conversionservice正在使用的依赖项。通常，需要的任何依赖项在创建时都可能未完全初始化。如果自定义的conversionservice不需要配置 keys 强转，并且仅依赖于使用@configurationpropertiesbinding限定的自定义转换器，则可能需要将它重命名。
springboot 对表示持续时间有专门的支持。如果暴露 java.time.duration 属性，则可以用以下格式：
long 表示（除非指定了 @durationunit，否则使用毫秒作为默认单位）java.time.duration 使用的标准 iso-8601 格式@configurationproperties("app.system")
public class appsystemproperties {
@durationunit(chronounit.seconds)
private duration sessiontimeout = duration.ofseconds(30);
private duration readtimeout = duration.ofmillis(1000);
public duration getsessiontimeout() {
return this.sessiontimeout;
}
public void setsessiontimeout(duration sessiontimeout) {
this.sessiontimeout = sessiontimeout;
}
public duration getreadtimeout() {
return this.readtimeout;
}
public void setreadtimeout(duration readtimeout) {
this.readtimeout = readtimeout;
}
}
要指定 30 秒的 sessiontimeout，30、pt30s 和 30s 都是等效的。500ms 的 readtimeout 可以用以下任何形式指定：500、pt0.5s 和 500ms。
也可以使用以下任何支持的单位：
ns：纳秒us：微妙ms：毫秒s：秒m：分h：时d：天默认的单位是毫秒，可以使用
@durationunit指定
spring 框架有一个 datasize 类型，以字节表示大小。如果暴露一个 datasize 属性，则可以用以下格式：
long 表示（除非指定了 @datasizeunit，否则使用字节作为默认单位）java.time.duration 使用的标准 iso-8601 格式10mb 表示 10 兆字节）。@configurationproperties("app.io")
public class appioproperties {
@datasizeunit(dataunit.megabytes)
private datasize buffersize = datasize.ofmegabytes(2);
private datasize sizethreshold = datasize.ofbytes(512);
public datasize getbuffersize() {
return this.buffersize;
}
public void setbuffersize(datasize buffersize) {
this.buffersize = buffersize;
}
public datasize getsizethreshold() {
return this.sizethreshold;
}
public void setsizethreshold(datasize sizethreshold) {
this.sizethreshold = sizethreshold;
}
}
要指定 10 兆字节的 buffersize，10 和 10mb 是等效的。256 字节的 sizethreshold 可以指定为 256 或 256b 。
也可以使用以下任何支持的单位：
b：字节
kb：千字节
mb：兆字节
gb：千兆字节
tb：兆兆字节
默认的单位是字节，可以使用
@datasizeunit指定
每当对 @configurationproperties 类使用 spring 的@validated 注解时，spring boot 就会验证它们。可以直接在配置类上使用 jsr-303 javax.validation 约束注解。必须确保类路径上有一个兼容的 jsr-303 实现（如：hibernate-validator），然后将约束注解添加到字段中。
@configurationproperties(prefix="acme")
@validated
public class acmeproperties {
@notnull
private inetaddress remoteaddress;
// ... getters and setters
}
注意：还可以通过注解@bean 方法来触发验证，该方法使用@validated 创建配置属性。
尽管嵌套属性在绑定时也将被验证，但最好对关联字段使用
@valid。这确保即使找不到嵌套属性，也会触发验证。
@configurationproperties(prefix="acme")
@validated
public class acmeproperties {
@notnull
private inetaddress remoteaddress;
@valid
private final security security = new security();
// ... getters and setters
public static class security {
@notempty
public string username;
// ... getters and setters
}
}
还可以通过创建
configurationpropertiesvalidatorbean 来添加自定义 springvalidator。@bean方法应该声明为static。配置属性验证器是在应用程序生命周期的早期创建的，将@bean 方法声明为 static 可以创建 bean，而无需实例化@configuration 类。这样做可以避免任何可能由早期实例化引起的问题。
注意：
spring-boot-actuator模块包含一个端点，该端点暴露所有@configurationpropertiesbean。访问/actuator/configprops可获得相关信息。
@value 注解是一个核心容器特性，它不提供与 @configurationproperties 相同的特性。
如果需要为组件定义了一组配置键，建议将它们配置到一个
@configurationproperties注解的 pojo 中。由于@value不支持松绑定，如果需要使用环境变量提供值，则它不是一个好的选项。
虽然可以在@value中编写spel表达式，但此类表达式不会从 properties 文件中处理。
如果项目比较大的话，分成了好几个 springboot 工程，可以使用某些 springcloud 组件，比如：配置中心。配置中心支持一个地方管理所有的配置，有些还可以支持修改配置实时生效而不用重启应用，真的是很棒棒呢。推荐使用 nacos。如果项目比较小，你用 git 或者指定文件夹来作为配置存放的地方也可以。
怎么样？有了这些用法的支持，你还会觉得 springboot 打成一个 jar 会在部署的时候很不方便吗？
官方文档
公众号：逸飞兮（专注于 java 领域知识的深入学习，从源码到原理，系统有序的学习）
如对本文有疑问， 点击进行留言回复！！
before社区电量是什么意思 Before社区电量获得方法
RecycleView入门详解（教你全面掌握RecycleView用法）
动态权限请求框架RxPermissions(几行代码搞定权限)
URL路径@PathVariable出现点号“.“时值遭截断问题
网友评论