Spring Boot 2.3.0正式发布：优雅停机、配置文件位置通配符新特性一览

当大潮退去，才知道谁在裸泳。。关注公众号【BAT的乌托邦】开启专栏式学习，拒绝浅尝辄止。本文 https://www.yourbatman.cn 已收录，里面一并有Spring技术栈、MyBatis、中间件等小而美的专栏供以学习哦。

目录

• 前言
  • 关于版本号
• 正文
  • 简单回忆2.2版本的新特性
  • 主要新特性
    • 优雅停机
    • 配置属性的调整
    • 删除不推荐使用的类/方法/属性
    • 配置文件位置支持通配符
    • web下的日期转换支持配置
  • 其它新特性
    • 更改某些依赖最低版本要求
    • 核心依赖升级
    • 三方库依赖升级
    • Spring Data Neumann升级带来的变化
    • 关于Validation
    • 移除一些maven插件
    • 支持Java14
    • Docker支持
    • Fat Jar支持优化
    • 嵌入式Servlet Web Server线程配置
    • WebFlux基础路径配置
    • 活性探测器
    • Actuator增强
• 好基友Spring Cloud什么时候跟上？
• 升级建议：等等
• 总结

前言

各位小伙伴大家好，我是A哥。北京时间2020-05-15，Spring Boot 2.3.0版本正式发布了，次版本号的升级，一般会有些新特性出来。作为Java Coder的我们有必要一览它的新new Feature，keep下技术节奏嘛。

A哥“第二时间”知道了这个消息，然后在自己本机（请注意：非生产环境）体验了一把，然后再结合Spring Boot官方的Release Notes，在这里给你絮叨絮叨。

---

关于版本号

Spring Boot代码库的版本好采用“国际通用”（我自己yy的）的命名方式：主版本号.次版本号.修订号，所以通过版本号就能感受到它的变化到底大不大，你升级时是否需要倍加注意等等。那么此处我就对这种命名方式版本号的各段进行科普一波：

• 主版本号：完全不兼容。产品定位变化、核心API大规模不兼容（比如包名变了）、架构方式升级不能向下兼容......
  • 举例：Configuration1.x -> 2.x；Zuul1.x -> 2.x；Spring Boot1.x -> 2.x；Netty4.x -> 5.x
• 次版本号：相对兼容。一般是增加新特新，删除掉废弃的API，修改某些API不兼容。总的来说是影响比较小，在可控范围内的，但升级时不可掉以轻心，必须做前期调研
• 修订号：100%兼容。一般是修复bug、新增无伤大雅的一些特性等，一般想升就升

这次Spring Boot升级到2.3.0版本，属于次版本号的升级，因此会带有些新特性，还是值得一看的。

正文

Spring Boot v2.2依然是活跃的维护的版本，Spring Boot遵循的是Pivotal OSS支持策略，从发布日期起支持主要版本3年。但是呢，一般来说在主要/次要版本发布时，将会对上个主要版本至少提供12个月的支持（即使超过了3年），以解决关键的bug或者安全问题。

关于其它版本的维护活跃状态和已经EOL的日期，做出如下说明：

• 2.2.x：支持的版本。2019.10发布，是现在的活跃的主干
• 2.1.x：支持的版本。2018.10发布，会支持到2020.10月底
• 2.0.x：生命已终止的版本。2018.3发布，2019.4.3停止维护
• 1.5.x：生命已终止的版本。2017.1发布，是最后一个1.x分支，2019.8.1停止维护

从官网页面也可以看出，只有支持的版本才会被列出来，对使用者是有一定的引导作用的：

---

简单回忆2.2版本的新特性

很明显，Spring Boot2.2版本不是本文关心的重点，但为了起到衔接作用，本处把它的核心新特性列一下：

1. Spring Framework 5.2：重大升级，可以看到它为Cloud Native的努力
2. JUnit 5：从此版本开始，spring-boot-starter-test默认使用JUnit 5作为单元测试框架
3. 支持Java13
4. 性能提升：表现在对所有的自动配置类改为了@Configuration的Lite模式，提升性能。
5. 新增@ConfigurationPropertiesScan注解，自动扫描@ConfigurationProperties配置类
6. 支持RSocket

下面我们来了解下本次升级（2.3.0版本）的新特性，分为主要新特性和其它新特性分开阐述。

---

主要新特性

优雅停机

这个新特性深入人心，是开发者、运维的福音啊。据我了解，很多中小型公司/团队都是使用kill -9（当然有些比较“温柔”的团队也用kill -2）来停服的，这样暴力“停机”很容易造成业务逻辑执行失败，导致在一些业务场景下出现数据不一致现象。虽然我们可以通过一些手段（自研）来避免这个问题，但并不是每个公司/团队都去做了。这不Spring Boot2.3.0版本就内置了这个功能：优雅停机。

小知识：kill -2类似于你的Ctrl + C，会触发shutDownHook事件（从而关闭Spring容器）；kill -9就没啥好说的，杀杀杀

SB所有四个嵌入式web服务器(Jetty、Reactor Netty、Tomcat和Undertow)以及响应性和基于servlet的web应用都支持优雅的关闭。在关闭时，web服务器将不再允许新的请求，并将等待完成的请求给个宽限期让它完成。当然这个宽限期是可以设置的：可以使用spring.lifecycle.timeout-per-shutdown-phase=xxx来配置，默认值是30s。

注意，注意，注意：默认情况下，优雅关机并没有开启（还是立即关机），你仅需添加server.shutdown=graceful配置即可开启优雅关机（取值参见2.3.0新增的Shutdown枚举类，默认值参见AbstractConfigurableWebServerFactory.shutdown属性值）。

---

配置属性的调整

这个版本中，一些配置属性已被重命名或弃用（这会导致不向下兼容，需要特别引起注意），需要你做出调整。

那么如何知道我现在用的哪些属性存在不兼容情况呢？？？官方给了一个很好的解决方案，这里我用个使用示例教你可以这么处理：

现状：在Spring Boot2.2.x环境中你有很多配置，痛点是不知道哪些配置需要配替换成2.3.x中新的。此时你可以在工程下加入这个jar：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-properties-migrator</artifactId>
    <scope>runtime</scope>
</dependency>

然后升级你的Spring Boot版本号为2.3.0，重新启动工程。本处以你配置文件里的spring.http.encoding.enabled=true为例，由于使用了SB的最新版本，因此可以在控制台看到如下日志输出：

Property source 'applicationConfig: [classpath:/application.properties]':
	Key: spring.http.encoding.enabled
		Line: 3
		Replacement: server.servlet.encoding.enabled

日志说够明确了吧。有了这个好帮手，妈妈就不用再担心辣么多的配置项需要自己一个个去核对喽，按照指示一个个的修改即可。

官方说明：完成迁移后，请确保从项目的依赖项中删除properties-migrator这个模块。

顺道说一下：升级到2.3.0版本号，属性变化主要是这个：spring.http. -> server.servlet.encoding.、spring.mvc.、spring.codec.

---

删除不推荐使用的类/方法/属性

在该版本中，Spring Boot删除了2.2版本中不推荐使用的大多数类，方法和属性。请确保升级之前没有再调用不推荐使用的方法。针对于此，下面我举例那些在2.2版本中还“活着”但被弃用（标记有@Deprecated注解），但在2.3版本中已完全删除的类、方法、属性：

1. 方法BindResult#orElseCreate
2. 属性LoggingApplicationListener#LOGFILE_BEAN_NAME
3. 类JodaDateTimeJacksonConfiguration
4. 类JestAutoConfiguration

即使如此，有些虽然在2.2就已被弃用，但在2.3.0还存在的，如：ConfigurationBeanFactoryMetadata、CompositeHealthIndicator

---

配置文件位置支持通配符

Spring Boot现在在加载配置文件时支持通配符位置。默认情况下，jar外部的config/*/位置是被支持的。当配置属性有多个源时，比如在Kubernetes这样的环境中非常有用。

特点说明：jar包外，jar包外，jar包外，放在内部（比如resource目录下是没有此特针的），下面有示例证明

简单的说，如果你有MySql的配置和Redis配置的话，你就可以把他们分开来放置，隔离性更好目录也更加清晰了：

• mysql：/config/mysql/application.properties
• redis：/config/redis/application.properties

工程目录如下截图：



运行程序：

public static void main(String[] args) {
    ConfigurableApplicationContext context = SpringApplication.run(Boot23Demo1Application.class, args);

    ConfigurableEnvironment environment = context.getEnvironment();
    System.out.println(environment.getProperty("mysql.name"));
    System.out.println(environment.getProperty("redis.name"));

    context.close();
}

结果输出：

mysql
redis

但如果你把文件放在jar包内，形如这样，是没有效果的：



输出为null null，因此使用时需要稍加注意哈~

---

web下的日期转换支持配置

现在时间/日期的转换现在可以通过属性进行配置了，这补充了对格式化日期值的现有支持。比如对于MVC和WebFlux来说，它们的配置项分别如下：

• spring.mvc.format.date
• spring.mvc.format.date-time
• spring.mvc.format.time
• spring.webflux.format.date
• spring.webflux.format.date-time
• spring.webflux.format.time

这个怎么用，相信大家都会，一看就知道什么含义。但是，但是，但是：请一定做好充分测试，并且充分考虑兼容性，因为你这动的是接口层的东西~

---

---

其它新特性

更改某些依赖最低版本要求

主要体现在如下两处：

1. 如果你使用Gradle构建，支持Gradle 6.3+ 。当然喽5.6.x也支持，只是标记为@Deprecated不推荐使用了
2. 如果你使用Jetty嵌入式容器，版本要求是Jetty 9.4.22+

---

核心依赖升级

Spring Boot 2.3迁移到几个Spring项目的新版本:

• Spring Data Neumann：你可以理解为它就是之前的Spirng Data工程的升级版
• Spring HATEOAS 1.1
• Spring Integration 5.3
• Spring Kafka 2.5
• Spring Security 5.3
• Spring Session Dragonfruit

Spring Boot 2.3的构建与Spring Boot 2.2基于 相同的 Spring Framework和Reactor。

说明：spirng-core么有升级，还是5.2.6版本（SB的2.2.7版本依赖的spring-core也是这个版本）

---

三方库依赖升级

• AssertJ 3.16
• Cassandra Driver 4.6
• Elasticsearch 7.6
• Hibernate Validator 6.1
• JUnit Jupiter 5.6
• Kafka 2.5
• Lettuce 5.3
• Micrometer 1.5
• MongoDB 4.0

---

Spring Data Neumann升级带来的变化

• Cassandra：升级到v4版本，带来了一些变化，如ClusterBuilderCustomizer就木有了~
• Couchbase：升级到v3版本
• Elasticsearch：已废弃的原生Elasticsearch transport直接被删除了，并且还移除了对Jest的支持。从此版本开始，默认支持Elasticsearch7.5+
• MongoDB：升级到v4版本

---

关于Validation

从此版本开始，spring-boot-starter-web不会再把validation带进来，所以若使用到，你需要自己添加这个spring-boot-starter-validation依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

关于spring-boot-starter-web启动器新、老版本的区别截图：

---

移除一些maven插件

移除了对exec-maven-plugin和maven-site-plugin这两个插件的管理，所以如果你的工程依赖于这两个插件，那么你得显示的导入（指定版本号）。

---

支持Java14

Spring Boot 2.3增加了对Java 14的支持。当然Java 8和Java 11也还是被支持的。

---

Docker支持

在Maven和Gradle插件中添加了对构建包含分层内容的jar文件的支持。分层根据jar内容的更改频率来分隔它们。这种分离允许更有效地构建Docker映像。未更改的现有层可以与已更改的层一起放在顶部进行重用。

根据您的应用程序，您可能需要调整层的创建方式并添加新层。这可以通过描述如何将jar分成层以及这些层的顺序的配置来完成。

---

Fat Jar支持优化

用Maven和Gradle构建的Fat jar现在包括一个索引文件。当jar被分解时，这个索引文件用于确保类路径的顺序与直接执行jar时相同。

---

嵌入式Servlet Web Server线程配置

用于配置嵌入式Servlet web服务器使用的线程的配置属性（包括Jetty, Tomcat, 和Undertow）别移动到了专注于threads的组：erver.jetty.threads，server.tomcat.threads，server.undertow.threads。当然喽，旧的配置属性目前依然保留着，但被标记为@Deprecated不再推荐使用了~

---

WebFlux基础路径配置

现在可以配置WebFlux应用程序的所有web处理程序的基本路径。使用pring.webflux.base-path = xxx配置。

---

活性探测器

Spring Boot现在内置了关于应用程序可用性的探测的能力，可以跟踪应用程序是否处于活动状态以及是否准备好处理流量。如果你配置了management.health.probes.enabled=true，那么健康检查端点就可以查看你应用的活性和就绪列表，这在在Kubernetes上运行时，这是自动完成的。

---

Actuator增强

主要是对端点做了些输出、显示上的优化。如：

• /actuator/metrics/：按字母顺序排列，这样你找起来就更方便了
• DataSource的HealthIndicator健康指示器，现在进行无查询判断，而Connection仅做连接可用性验证而已
• ...

---

---

好基友Spring Cloud什么时候跟上？

作为Spring Boot的好基友，按照以往的惯例，他俩的步调不一般都保持基本一致。戒指到当前，Spring Cloud的最新版本是Hoxton SR4，那它是否支持最新的Spring Boot2.3.0呢？？？答案是：不支持，不支持，不支持。对于Spring Boot这种跨版本升级，一般是有阻断性变化，所以它的机油SC适配上还需要时间。

这不，官方就公布了Spring Cloud支持Spring Boot 2.3.x的里程碑时间点，也就是它的Hoxton.SR5版本发布时间点：



Spring Cloud里程碑地址：https://github.com/spring-cloud/spring-cloud-release/milestones

---

升级建议：等等

至少要等到2020-5-26号发布后嘛，至少要等到Spring Boot2.3.x跑一段时间之后嘛，坐在第二排看戏，才是最舒服最稳妥的。

---

总结

这是A哥奉给大家的，对Spring Boot2.3.0版本新特性的介绍，希望对你有些帮助。有些人可能会这么说：反正我现在也不用这个版本，没有必要去了解它。其实非也，如果你2.3.0不去了解，2.4.0不去了解，倘若某一天你突然要从2.0.0版本过度过来使用2.5.x版本了，你会“浑身不舒服”的。你品下，是不是这么个道理呢？