Spring Boot 3 アプリケーション移植手順
（STS4 → Spring Tools for Eclipse 5.0.1 / Spring Boot 4）

本手順書は、STS4 で開発した Spring Boot 3 の Web アプリケーション shitenapp02 を、 Spring Tools for Eclipse 5.0.1（以下 STS5）上の Spring Boot 4 アプリケーション shitenapp03 として 移植する手順をまとめたものです。

過去に STS / VSCode で Spring Boot の開発経験がある方向けに、 基本事項は省略し、移植時に間違えやすいポイントを中心に記載しています。

1. 新規 Spring Boot 4 プロジェクトの作成

  1. STS5 を起動し、Create New Spring Starter Project を選択します。
  2. ほぼ空の Spring Boot 4 プロジェクトとして shitenapp03 を作成します。
注意：
ここでは「移植元の設定を極力引きずらない」ため、 Dependencies は最小構成で問題ありません。

2. ソースコードのコピー

  1. 既存プロジェクト shitenapp02 の src 配下をすべてコピーします。
  2. コピーした内容を shitenapp03 の src 配下に上書きコピーします。
注意：
build.gradle や settings.gradle はコピーせず、 STS5 側で作成されたものをベースに修正します。

3. メインクラス名とパッケージ名の変更

3.1 メインクラス名変更

3.2 パッケージ名変更

注意：
パッケージ名変更後は、import エラーが大量に出るのは正常です。 後続手順でまとめて解消します。

4. MyBatis Mapper 関連の修正

  1. 以下のディレクトリ名を変更します。 
    src/main/resources/local/shitenapp02/mapper
→
src/main/resources/local/shitenapp03/mapper
  2. ShitenMapper.xml を開き、 shitenapp02 を shitenapp03 に置換します。
注意：
namespace や SQL 内の fully qualified class name を 置換し忘れやすいので注意してください。

5. Gradle 設定ファイルの修正

5.1 settings.gradle

rootProject.name = 'shitenapp03'

5.2 application.properties

以下の設定を shitenapp02 → shitenapp03 に変更します。 

spring.application.name=shitenapp03
server.servlet.context-path=/shitenapp03

6. Lombok のセットアップ（STS5）

  1. STS を一旦終了します。
  2. lombok.jar をローカルリポジトリ等から取得します。
  3. 以下のディレクトリに配置します。 
    C:\Wintools\sts-5.0.1.RELEASE
  4. SpringToolsForEclipse.ini を編集し、以下を追記します。 
-javaagent:lombok.jar

その後、STS を起動します（最初の 1 回は管理者モード推奨）。

注意：
STS5 では Lombok が自動有効にならない場合があります。 この設定を忘れると @Getter / @Setter などで大量にエラーが出ます。

7. build.gradle の編集

7.1 repositories 設定

ローカルリポジトリに自作 JAR がある場合、必ず先頭に mavenLocal() を追加します。 

repositories {
    mavenLocal()
    mavenCentral()
}

7.2 dependencies の追加

// for Thymeleaf Layout Dialect
implementation 'nz.net.ultraq.thymeleaf:thymeleaf-layout-dialect'

implementation 'ushi-group:ushi:1.0.0'
implementation 'ushi-group:ushiexp:1.0.0'

implementation 'org.apache.poi:poi:5.4.1'
implementation 'org.apache.poi:poi-ooxml:5.4.1'

7.3 Lombok の設定変更

// compileOnly 'org.projectlombok:lombok'
implementation 'org.projectlombok:lombok'
注意：
compileOnly のままだと実行時に Lombok が効かないケースがあるため、 implementation に変更します。

8. Gradle リフレッシュ

  1. build.gradle を右クリック
  2. Gradle → Refresh Gradle Project を選択します。

9. コンパイルエラー対応

  1. エラーが出ているクラスを開きます。
  2. Ctrl + Shift + O（Organize Imports）を実行します。
補足：
パッケージ変更後の import 修正は、 手作業より Organize Imports の方が安全です。

10. 実行構成（Run Configuration）の設定

  1. STS の実行アイコン「?」右側の ▼ をクリック
  2. Run Configurations... を選択
  3. Spring Boot App - shitenapp03 を選択
  4. VM Arguments に以下を設定します。 
-Dspring.profiles.active=local

11. アプリケーションの起動

  1. Package Explorer で shitenapp03 を選択します。
  2. メニューバーから以下を選択します。 
    Run → Spring Boot App

12. 動作確認

ブラウザから context-path を含む URL にアクセスし、 画面が正常に表示されれば移植完了です。

以上で、STS4（Spring Boot 3）から STS5（Spring Boot 4）への Web アプリケーション移植作業は完了です。