一、springboot3.0 -> springboot3.1
1、Apache HttpClient 4的依赖管理
Spring Framework 6删除了对Apache HttpClient 4 RestTemplate 的支持,转而支持Apache HttpClient 5。Spring Boot 3.0为HttpClient 4和HttpClient 5都提供了依赖管理。当使用 RestTemplate 时,继续使用HttpClient 4的应用程序可能会遇到难以诊断的错误。
Spring Boot 3.1移除了HttpClient 4的依赖管理,鼓励用户迁移到HttpClient 5。
2、Servlet和Filter注册
如果注册失败, ServletRegistrationBean 和 FilterRegistrationBean类别现在将失败,并返回 IllegalStateException ,而不是记录警告。如果想继续忽略注册失败 ,可以调用注册bean上的setIgnoreRegistrationFailure(true) 。
3、Git Commit ID Maven插件版本属性
io.github.git-commit-id:git-commit-id-maven-plugin 版本的属性更新,pom.xml将 git-commit-id-plugin.version 替换为 git-commit-id-maven-plugin.version
Git-Commit-Id-Plugin 可以自动的将git版本信息生成到 classes 目录下的 git.properties 文件中。
#Generated by Git-Commit-Id-Plugin
#Wed Mar 13 13:58:17 CST 2024
git.branch=
git.build.time=2024-03-13 13\:58\:17
git.build.version=1.0.0-SNAPSHOT
git.commit.id=
git.commit.id.abbrev=
git.commit.id.describe=
git.commit.id.describe-short=
git.commit.message.full=
git.commit.message.short=
git.commit.time=2024-03-11 13\:49\:13
4、Spring Kafka重试主题自动配置
当使用带有自动配置的可重试主题配置( spring.kafka.retry.topic.enabled: true )的Apache Kafka时,以 maxDelay 配置参数回退,所有 maxDelay 级别的重试现在都发送到同一个主题。 以前,即使超过了最大延迟,每次重试都使用一个单独的主题。
例如:最大重试次数为 5 ,延迟时间为 1s ,倍数时间为 2 ,最大延迟时间为 3s ,初始失败后重试时间为1s、2s、3s、3s。
之前的Spring Boot版本:框架会创建6个主题: someTopic 、 someTopic-retry-0 、 someTopic-retry-1 、 someTopic-retry-2 、 someTopic-retry-3 、 someTopic-dlt
在当前的Spring Boot版本中,即使超过了最大延迟时间(在这个例子中是3s),所有达到这个最大延迟级别的重试都会发送到同一个主题。这意味着someTopic-retry-3主题不会被创建,而是所有3秒的重试都会在someTopic-retry-2主题中进行。
5、Testcontainers的依赖管理
Spring Boot的依赖管理现在包含了Testcontainers
TestContainers 是一个用于简化集成测试的库,该库的核心思想是在测试期间启动和管理 Docker 容器,以便测试可以在真实的环境中运行,而不是在模拟的环境中。例如可以配置mysql、kafka等,测试时自动创建docker容器。实现应用启动时自动创建mysql、kafka等容器。
6、Spring Boot 3.1升级到Hibernate 6.2
https://docs.jboss.org/hibernate/orm/6.2/migration-guide/migration-guide.html
7、Jackson 2.15
Spring Boot 3.1升级到Jackson 2.15
https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.15
8、Mock测试
Spring Boot 3.1升级到了Mockito 5,具体来说就是5.3。请参阅 Mockito发布了notes来了解5中的显著变化
https://github.com/mockito/mockito/releases/tag/v5.0.0
9、切换到 maven.compiler.release
spring-boot-starter-parent 现在使用 maven.compiler.release 来配置Java版本,而不是 maven.compiler.source 和 maven.compiler.target 。 source 和 target 属性被去除。
maven.compiler.release 是 Maven 编译插件中的一个属性,用于指定 Java 编译器的版本。这个属性是在 Java 9 引入的模块系统之后新增的,它允许开发者在编译时同时指定源码(source)、目标字节码(target)以及用于编译的 JDK 的版本。
在 Maven 的 pom.xml 文件中,可以通过配置properties元素来设置 maven.compiler.release。例如,如果你想要使用 JDK 9 来编译你的项目,你可以这样设置:
<properties>
<maven.compiler.release>9</maven.compiler.release>
</properties>
设置 maven.compiler.release 后,Maven 会使用相应的 JDK 版本来编译源码,并生成对应版本的字节码。
值得注意的是,使用 maven.compiler.release 需要确保你使用的 Maven 编译插件的版本至少是 3.6.1,因为这个版本的插件才支持 Java 9 的模块系统。
10、配置变更
https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-3.1.0-Configuration-Changelog
11、spring-boot-docker-compose
与Docker Compose的集成
当你的应用启动时,Docker Compose集成将在当前工作目录中查找配置文件。 支持以下文件:
compose.yaml
compose.yml
docker-compose.yaml
docker-compose.yml
假设你已经有一个 Spring Boot 应用,并且已经为它创建了一个 Dockerfile
# 使用官方提供的 Java 运行时环境作为父镜像
FROM openjdk:8-jdk-alpine
# 将当前目录下的所有文件复制到容器的 /app 下
COPY ./target/myapp.jar /app/myapp.jar
# 设置工作目录为 /app
WORKDIR /app
# 容器启动时运行 java -jar myapp.jar
ENTRYPOINT ["java","-jar","myapp.jar"]
下面是一个简单的 docker-compose.yml 文件
version: '3'
services:
myapp:
build:
context: .
dockerfile: Dockerfile
ports:
- "8080:8080"
depends_on:
- db
db:
image: postgres
environment:
- POSTGRES_DB=myappdb
- POSTGRES_USER=myappuser
- POSTGRES_PASSWORD=myapppass
ports:
- "5432:5432"
在这个 docker-compose.yml 文件中:
我们定义了两个服务:myapp 和 db。
myapp 服务使用当前目录下的 Dockerfile 构建镜像,并映射容器的 8080 端口到主机的 8080 端口。
myapp 服务还依赖于 db 服务,确保数据库服务先启动。
db 服务使用官方的 postgres 镜像,并设置了一些环境变量来配置数据库。
要运行这个 Docker Compose 配置,
你可以打开终端,导航到包含 docker-compose.yml 文件的目录,并运行以下命令:
docker-compose up
这将构建 myapp 服务的镜像,启动 db 和 myapp 容器。
12、SSL配置
SSL信任材料(如Java密钥库和pem编码的证书)可以使用属性配置了,如嵌入式web服务器、数据服务、 RestTemplate 和 WebClient
保护嵌入式web服务器时,keystore 通常配置一个包含证书和私钥的Java密钥库
spring.ssl.bundle.jks.mybundle.key.alias=application
spring.ssl.bundle.jks.mybundle.keystore.location=classpath:application.p12
spring.ssl.bundle.jks.mybundle.keystore.password=secret
spring.ssl.bundle.jks.mybundle.keystore.type=PKCS12
13、Spring Authorization Server的自动配置
这个版本提供了对Spring Authorization Server项目的支持,替代原有的 Spring Security OAuth,同时还提供了一个新的 spring-boot-starter-oauth2-authorization-server
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-oauth2-authorization-server</artifactId>
</dependency>