SpringBoot3対応したので大体の対応を書いてみる

💡この記事でわかること・解決すること

そもそもSpringBoot3対応とは？

• 新機能の活用：Spring Boot 3では、新たな開発ツールや高度なセキュリティ対策など、新たな機能が導入されることが予想されます。これらの新機能を活用するためには、それらに対応するコードの修正やアップデートが必要です。

• バージョンアップに伴う変更対応：バージョンアップには、既存の機能やAPIが変更、廃止される場合があります。そのため、新バージョンに適合させるために、アプリケーションの調整が必要になります。

• 依存性の更新：Spring Bootのバージョンアップは、他のライブラリやフレームワークのバージョンアップも伴うことがよくあります。これらの変更に対応するためには、依存関係の更新とそれに伴うコードの修正が必要です。

• テストの更新：新バージョンへの対応は、単体テストや結合テストの更新を必要とします。新しい機能に対する新たなテストケースや、既存のテストケースの更新が必要となります。調整が必要となるでしょう。

✌️やったこと

🧱 壁1: Override, abstractメソッドで書かれてるenumクラスでmock化されてるとテスト自体が失敗する！

前提

• org.mockito:mockito-core:5.4.0

• groovy, spock

サンプル

public enum ItemType {
  A(0) {
    @Override
    public boolean isHoge() { return true; }
  },
  B(1) {
  };
	private final int number;
  
  public boolean isHoge() { return false; }
}

ではどうするのか？

• enumクラスの実装を書き換える😱
• テストが動かないから実装を変えるというのは本末転倒です。
• テストのためにテスタブルな設計をするならまだ良いですが、〇〇のテストが動かないから実装を変えようはあまりよろしくありません。こちらは選択しませんでした。

• enumクラスをモック化せずにテストを書く <= 私達のチームはこちらを選択
• そもそもenumクラスをモックしたいときってどんなときでしょうか？そこまで面倒な処理がenumに入ってるのは設計から疑うべきです。既存のテストコードはモックしたくて書いていたわけではなく、習慣的に書かれていただけなので、修正は1hくらいで終わりました。

🧱 壁2: integration-testのMock化のところで呼ばれないメソッドがあり、テスト失敗する

Mockito.verify(
  hogeService,
  Mockito.times(1)
).hogeMethod() == null

🍠 TIPS OpenRewriteで一気にSpringBoot対応の変更点をまとめて変更する

【OpenRewrite】コードを自動で一括変更

アプリケーションを運用していると、OSSのversion upや脆弱性対応等で複数のコード・アプリケーションに同じ変更を入れていかなければならないことがあります。 変更内容さえ決まってしまえば単純作業をするだけになってし ...

https://hirabay.net/?p=292

---
type: specs.openrewrite.org/v1beta/recipe
name: custom.SpringBootMigration
displayName: springboot migration to 3.1
recipeList:
  - org.openrewrite.gradle.plugins.UpgradePluginVersion:
      pluginIdPattern: org.springframework.boot
      newVersion: "3.1.2"
  - org.openrewrite.gradle.plugins.UpgradePluginVersion:
      pluginIdPattern: io.spring.dependency-management
      newVersion: "1.1.0"
  - org.openrewrite.gradle.ChangeDependencyVersion:
      groupId: org.mybatis.spring.boot
      artifactId: mybatis-spring-boot-starter
      newVersion: 3.0.2
  - org.openrewrite.gradle.ChangeDependencyVersion:
      groupId: jp.co.yahoo.cloudtools
      artifactId: contrail-spring-boot-starter
      newVersion: 2.1.0
  # javax → jakartaの更新
  - org.openrewrite.java.migrate.jakarta.JavaxMigrationToJakarta
  # spring.factoriesの移行
  - org.openrewrite.java.spring.boot2.MoveAutoConfigurationToImportsFile
  # プロパティの移行
  - org.openrewrite.java.spring.boot3.SpringBootProperties_3_1_2

plugins {
    ...
    // OpenRewriteプラグインを追加する
    id("org.openrewrite.rewrite") version("6.2.1")
}
 
...
 
repositories {
    mavenCentral()
}
 
dependencies {
    // 書換に必要な依存を追加
    rewrite("org.openrewrite.recipe:rewrite-spring:5.0.7")
    rewrite("org.openrewrite:rewrite-gradle:8.1.2")
    // OOMになることがあるので入れる https://github.com/openrewrite/rewrite/issues/1312
    rewrite("io.github.classgraph:classgraph:4.8.143")
}
 
// 実行するレシピを定義
rewrite {
    // 先ほど定義したレシピのnameを指定する
    activeRecipe('custom.SpringBootMigration')
}

./gradlew rewriteDryRun

./gradlew rewriteRun

maven { url "http://example.com" }

# 下記コマンドを実行してJava17に対応したバージョンに上げる
./gradlew wrapper --gradle-version=8.2.1