前段时间 Spring Boot 2.4.0 发布了,栈长作了一个新特性全盘解读,其中介绍了一个很重要的变革,那就是配置文件。

配置文件可是每个框架的核心,不得不搞清楚,所以,这篇栈长就带大家深入实战了解下 Spring Boot 2.4 配置文件都有哪些具体变更,以及如何迁移,已助你决定是否迁移到 Spring Boot 2.4。

概要

Spring Boot 2.4 改进了处理 application.properties 和 application.yml 配置文件的方式。更新后的逻辑旨在简化和合理化外部配置的加载方式,但有些参数的组合形式却得到了限制,升级请谨慎。

如果你的应用工程只有一个简单的 application.properties 或 application.yml 文件,则可以进行无缝升级到 Spring Boot 2.4.0。

但是,如果你的配置较为复杂,比如说有指定 profile 的参数,或者有基于 profile 激活的参数,要使用新功能就需要进行一些更改。

更多细节可参考:

https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-Config-Data-Migration-Guide

变更细节

1、YAML 配置排序变更

如果你有一些配置参数,它们之间又是互相覆盖,那就要确保所需要的参数要放在文件最后。

如在 Spring Boot 2.3 中:

spring:
  profiles:
    active:
      - prod
      - prodmq
      - proddb

spring:
  profiles: prod

env: prod

spring:
  profiles: proddb

env: proddb

spring:
  profiles: prodmq

env: prodmq

Spring Boot 基础构建及 profile 基本介绍这里就不介绍了,关注公众号Java技术栈回复关键字 “boot”,可以阅读我写的几十篇往期实战文章。

Spring Boot 教程和示例代码已上传到 Github:

https://github.com/javastacks/spring-boot-best-practice

回到上面的配置,如果同时启用多个 profile 的话,后面的会覆盖前面的,即 proddb 里面的配置参数会覆盖 prodmq 的,所以 env 的值为:proddb。

而如果升级到了 Spring Boot 2.4,env 的值则为:prodmq,因为按顺序加载的话 prodmq 中的 env 在配置文件中最下方。

所以,如果升级到 Spring Boot 2.4,就需要检查 “profile” 这些配置参数之间的关系,可能还需要对 YAML 中的配置重新排序。

2、Profile 配置覆盖变更

如果你使用了 JAR 外部化配置,并且也使用了基于 “profile” 的特定配置文件,那你就要检查下配置是否按预期加载了。

因为在之前的版本中,JAR 包外部的 application.properties 配置文件不会覆盖 JAR 包里面的基于 “profile” 的 application-xxxprofile.properties 配置文件。

从 Spring Boot 2.4 开始,外部化配置参数会覆盖内部的配置参数(不管是否基于 “profile” 激活),这个也是修复 Spring Boot 上的的一个 Issue:

https://github.com/spring-projects/spring-boot/issues/3845

这个问题的就是指 JAR 包外部的应用程序参数应优先于 JAR 包内部的特定激活的配置参数。

3、Profile 配置参数变更

如果你使用了 spring.profiles 属性指定了多套 YMAL 配置文件,现在需要使用新参数替代:

spring.config.activate.on-profile

配置示例:

spring.config.activate.on-profile: dev

env: dev

server:
  port: 8080

spring.config.activate.on-profile: test

env: test

server:
  port: 8081

spring.config.activate.on-profile: prod

env: prod

server:
  port: 8082

spring.config.activate.on-profile: proddb

db:
  name: mysql

env: proddb

spring.config.activate.on-profile: prodmq

mq:
  address: localhost

env: prodmq

和之前的逻辑一样,可以继续使用 spring.profiles.active 来激活特定的 profiles 列表,或者也可以使用表达式激活,如:prod & cloud,但是不能和 spring.config.activate.on-profile 结合使用。

另外,如果你之前使用了 spring.profiles.includespring.profiles 结合使用,就需要使用新的 “profile group” 特性了。

配置 profile group 组示例:

spring:
  profiles:
    active:
      - prodall
    group:
      prodall:
        - prod
        - prodmq
        - proddb

这样就定义了一个 “prodall” 组,包含了 prod, proddb, prodmq 三个 profile,同时在配置文件中直接使用 spring.profiles.active 来激活 “prodall” 组,这样就同时激活了 prod, proddb, prodmq。

4、回归传统模式

如果你想继续使用 Spring Boot 2.3 的配置文件逻辑,或者还没准备好迁移到 Spring Boot 2.4,也可以通过在 application.properties 或者 application.yml 配置文件中添加以下参数回到传统模式:

spring.config.use-legacy-processing = true

如果不指定这个参数为:true,那么在 Spring Boot 2.4 中就是默认新的配置文件处理逻辑。

总结

总结下来,个人感觉某些变更着实没什么卵用,但也不得不跟上它的节奏。

所以大家一定要注意了,迁移到 Spring Boot 2.4,需要注意文中的配置变更细节,一定要对所有变更内容做调整,不然参数加载会受到影响。

本节所有实战源代码示例已上传至 Github:

https://github.com/javastacks/spring-boot-best-practice

好了,今天的分享就到这里了,单看官方文档还不是很清楚,栈长也是对配置升级的细节做了各个实践才明白其中的奥妙,希望对大家有帮助。

欢迎大家 Star 关注,后续会不断更新。

学习更多 Spring Boot 教程,请关注公众号Java技术栈,后面栈长还会继续推送一些 Spring Boot 2.4 新特性实战文章。在公众号后台回复:boot,历史 Spring Boot 教程我也都整理好了。

最后,别忘了点在看、转发哦,需要你的鼓励~

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注