我试用了Spring Boot 3.0

2 年 ago

新, 韵

2 minutes

這是「NSSOL 2022年過聖誕節的日曆」的第三天。因為事情突然要寫，所以我希望到12月底逐漸讓文章進一步發展起來。（藉口）

序言

2022年11月24日，备受期待的Spring Boot 3.0版本终于发布了。考虑到Spring Boot 2.0的发布日期是2018年3月1日，这次更新算是五年不到的重大版本升级。虽然其他网站已经介绍了该版本，但本次我们将根据官方网站和GitHub的说明进行各种尝试。

相较于Spring Boot 2，有什么变化。

我試著用星星來簡單表示重要性。(這是我的個人評價)

【★】@SpringBootTest with Main Methods

从Java 17开始可用的环境确实具有最大的影响力。
由于Spring Boot 2系支持Java 16，所以如果选择采用Java 17，则必然选择Spring Boot 3.0以上。

此外，据说GraalVM Native Image的支持能够实现内存节省和缩短启动时间。它的引入非常简单，您可以使用buildpack进行构建，或者在使用Maven/Gradle等构建工具时添加以下命令。如果您想了解更多信息，请参考官方网站上这个页面。

# Maven
mvn -Pnative native:compile

# Gradle
gradle nativeCompile

从Spring Boot 2.x版本进行升级

请参考公式的GitHub页面以获取详细信息，以下是主要要点的概述：
https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-3.0-Migration-Guide

预先准备

非推奨クラス・メソッドの確認

升级工作 jí zuò)

アップグレードが完了したら、依存関係から除くことを忘れないように。

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

# Gradle
runtime("org.springframework.boot:spring-boot-properties-migrator")

影響を受けるソースコードを修正します。変更が多岐にわたるので、手作業で修正していく場合は注意が必要です。

【★★★】Spring Framework 6.0
【★★★】Jakarta EE
【★★★】Core Changes
【★★★】Web Application Changes
【★★】Actuator Changes
【★★】Micrometer and Metrics Changes
【★★★】Data Access Changes
【★★★】Spring Security Changes
【★★】Spring Batch Changes
【★★】Spring Session Changes
【★★】Gradle Changes
【★★】Maven Changes
【★】Dependency Management Changes

もしマイグレーション対象が多くある等、極力手作業は排除したい場合は、以下のサイトで紹介されているようにOpenRewriteを利用する方法や、それを拡張したSpring Boot Migrator(SBM)もあるようです。もし試された方がいれば感想を教えてほしいです。
https://zenn.dev/cypher256/articles/b6e27b0556d012
https://github.com/spring-projects-experimental/spring-boot-migrator

似乎在Web应用程序中，GetMapping/PostMapping/RequestMapping指定的URL模式匹配的默认行为有些变化。

以往，即使不写最后的斜杠，也可以实现似乎有斜杠存在的行为。从现在起，需要明确地更改设置或按以下方式进行实施1。

@RestController
public class MyController {

  // 以下のように記載する
  @GetMapping({"/some/greeting","/some/greeting/"})
  public String greeting {
    return "Hello";
  }
}

另外，由于要使用Jakarta EE 9/10，因此需要修改软件包名称。这些案例非常易于理解。
https://developer.mamezou-tech.com/blogs/2022/09/25/ready-to-ee10/

关于迁移至Spring Security 6.0的指南，请点击此处。从初步查看，似乎没有太大的影响。但需要特别注意的是认证(Authentication)部分。

oauth2Login()方法的默认权限：
在Spring Security 5中，对于使用OAuth2或OpenID Connect 1.0提供商进行认证的用户（通过oauth2Login()方法），默认赋予的权限是ROLE_USER。
在Spring Security 6中，对于使用OAuth2提供商进行认证的用户，默认赋予的权限是OAUTH2_USER。对于使用OpenID Connect 1.0提供商进行认证的用户，默认赋予的权限是OIDC_USER。如果您仅为了升级到6.0而配置了GrantedAuthoritiesMapper，您可以完全删除它。

据说，用中文意思表示就是，在Spring Security 5中，默认的GrantedAuthority权限是ROLE_USER。而在Spring Security 6中，对于OAuth2的情况下是OAUTH2_USER，对于OIDC 1.0的情况下是OIDC_USER。