多くの企業がDXを推進する中で、既存のJSP資産を活用しつつ、Spring Bootの高速開発能力を取り入れたいと考えるシステムエンジニアの皆様へ。この記事では、私がブログ編集長として、またシステムエンジニアとしての経験を基に、Spring BootとJSPを効果的に連携させ、モダンなWebアプリケーションを構築するための具体的な手順と実践例を詳述します。
「Spring BootはJAR形式が主流でJSPは相性が悪いのでは？」といった疑問をお持ちの方もいらっしゃるかもしれません。ご安心ください。本記事では、その懸念を解消し、両者のメリットを最大限に引き出すWAR形式でのデプロイ戦略を中心に解説します。
目次
- なぜ今、Spring BootとJSPの連携が必要なのか？
- 前提知識：Spring BootとJSPの基本
- 実践：Spring Boot (WAR) とJSPでWebアプリを構築する手順
- 実践例：WebアプリA (JSPフロント) とWebアプリB (API) の連携
- まとめ：Spring BootとJSPで未来を切り拓く
- 次のステップへ：更なるDX推進のために
なぜ今、Spring BootとJSPの連携が必要なのか？
現代のシステム開発では、迅速な市場投入と高い保守性が求められます。Spring Bootは、その「設定より規約」の思想と豊富なスターターにより、開発効率を飛躍的に向上させます。一方で、多くの企業では長年培ってきたJSPベースの既存システムや、JSP開発に慣れた技術資産が存在します。
これら既存のJSP資産を捨て去ることは、コスト面やリスク面から非現実的な場合が多いです。そこで、Spring Bootのモダンな開発手法と、JSPの既存資産を両立させる連携が、現実的なDX推進の鍵となります。
特に、UI層はJSPで柔軟に表現しつつ、バックエンドのビジネスロジックやAPI連携はSpring Bootの強力な機能で構築するといったハイブリッド戦略は、多くの企業にとって最適な道筋となり得るでしょう。
前提知識：Spring BootとJSPの基本
本記事を最大限に活用していただくために、以下の基本的な知識があると理解が深まります。
- Spring Bootの基礎: 依存性注入（DI）、Webアプリケーション（MVC）、プロジェクト構造の理解。
- JSPの基礎: JSPの構文、EL式、JSTL、サーブレットコンテナでの動作原理。
- Mavenの基礎: `pom.xml`の読み書き、ビルドライフサイクル（`clean`, `package`など）。
- Tomcatの基礎: 環境変数（`CATALINA_HOME`）、デプロイ方法（WARファイル）。
特に、Spring BootがJAR形式で組み込みサーバーを持つのが主流である点と、JSPがサーブレットコンテナ上で動作するView技術である点を踏まえると、両者の連携には工夫が必要であることが理解できるでしょう。
実践：Spring Boot (WAR) とJSPでWebアプリを構築する手順
Spring BootとJSPを連携させる最も安定した方法は、Spring BootアプリケーションをWAR形式でビルドし、外部のTomcatにデプロイすることです。
ステップ1: プロジェクトの初期設定
- Spring Initializrでプロジェクトを生成:
- Project: Maven Project
- Packaging: WAR を選択
- Dependencies: `Spring Web`, `Tomcat Embed Jasper` (JSPコンパイル用)
注意: `tomcat-embed-jasper`は、WARパッケージングの場合、`provided`スコープに設定しがちですが、Spring BootアプリケーションとしてJAR実行も視野に入れるなら`compile`スコープのままでOKです。外部Tomcatにデプロイする際、Tomcat側がJSPコンパイル機能を提供するため問題ありません。
- `pom.xml`の確認:
生成された`pom.xml`に`packaging`タグが`war`になっていることを確認し、`spring-boot-starter-tomcat`や`tomcat-embed-jasper`が含まれていることを確認します。
<packaging>war</packaging> <!-- ... --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.apache.tomcat.embed</groupId> <artifactId>tomcat-embed-jasper</artifactId> </dependency>
ステップ2: JSPファイルの配置と設定
- JSPファイルの配置:
従来のWebアプリケーションと同様に、JSPファイルは`src/main/webapp/WEB-INF/jsp/`ディレクトリ以下に配置します。このパスは、TomcatがWARファイルを展開した際にJSPファイルを認識できる標準的な場所です。
src └── main └── webapp └── WEB-INF └── jsp └── welcome.jsp └── index.html (または他の静的ファイル) - `application.properties`の設定:
Spring BootにJSPの場所を教えるために、`src/main/resources/application.properties`にビューリゾルバーの設定を追加します。
spring.mvc.view.prefix=/WEB-INF/jsp/ spring.mvc.view.suffix=.jsp
ステップ3: コントローラの作成
JSPを表示するための簡単なSpring MVCコントローラを作成します。
package com.example.mywebapp.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
@Controller
public class ViewController {
@GetMapping("/welcome")
public String showWelcomePage() {
return "welcome"; // src/main/webapp/WEB-INF/jsp/welcome.jsp を解決
}
}
ステップ4: WARファイルのビルドとデプロイ
- WARファイルのビルド:
プロジェクトのルートディレクトリでMavenコマンドを実行し、WARファイルを生成します。
mvn clean package`target/`ディレクトリに`your-app-name.war`が生成されます。
- Tomcatへのデプロイ:
生成されたWARファイルを、インストール済みのTomcatの`%CATALINA_HOME%\webapps`ディレクトリにコピーします。
- Tomcatの起動:
Tomcatを起動または再起動します。
cd %CATALINA_HOME%\bin shutdown.bat # 必要であれば startup.batこれにより、TomcatがWARファイルを自動的に展開し、アプリケーションがデプロイされます。
- 動作確認:
ブラウザで`http://localhost:8080/あなたのWARファイル名（.warを除く）/welcome` にアクセスし、JSPページが表示されることを確認します。
実践例：WebアプリA (JSPフロント) とWebアプリB (API) の連携
ここからは、Spring Boot (WAR) のWebアプリAと、独立したAPIであるSpring Boot (JAR) のWebアプリBを連携させる具体的な実践例です。
WebアプリB (JAR) の準備 (ポート8081で動作)
WebアプリBは、Spring Boot (JAR) で構築し、Gemini APIと連携するRESTful APIとして動作させます。WebアプリAとのポート競合を避けるため、デフォルトの8080ポートではなく、例えば8081ポートを使用します。
- プロジェクト作成: `spring-boot-starter-web`, `com.google.generativeai:java-genai` を依存関係に持つJARプロジェクトとして作成。
- ポート設定: `src/main/resources/application.properties` に `server.port=8081` と `google.gemini.api-key=YOUR_API_KEY` を設定。
- API実装: Gemini API呼び出しロジックを持つ`GeminiApiService`と、JSON形式のリクエスト/レスポンスPOJO、そしてそれらを利用する`GeminiController` (`@RequestMapping(“/api/gemini”)`) を実装。
- ビルドと起動: `mvn clean package` でJARを生成し、`java -jar target/your-api-service.jar` で起動。
WebアプリA (WAR) からWebアプリBへの同期呼び出し
WebアプリAは、ユーザーからのリクエストを受け取り、JSPで表示するだけでなく、WebアプリBのAPIを同期的に呼び出し、その結果をJSPに渡す役割を担います。
- `RestTemplate`のBean定義: WebアプリAのメインクラスに`RestTemplate`のBeanを定義します。
- POJOのコピー: WebアプリBで定義した`GeminiRequest`と`GeminiResponse`のPOJOクラスを、WebアプリAのプロジェクトにもコピーします。
- APIクライアントサービスの作成: `WebBClientService`を作成し、`RestTemplate`を使用してWebアプリBのAPI (`http://localhost:8081/api/gemini/generate`) を呼び出すメソッドを実装します。WebアプリAの`application.properties`に`webb.api.url=http://localhost:8081`を設定します。
- JSP表示コントローラの修正: ユーザーのリクエストを受け取るコントローラを実装し、その中で`WebBClientService`を呼び出し、取得したレスポンスデータをJSPにモデル属性として渡します。
- JSPでの表示: JSP内でEL式などを使って、コントローラから渡されたデータを表示します。
これにより、ブラウザ（①非同期）→WebアプリA（②同期）→WebアプリB（③同期）→Gemini API（④同期）→WebアプリB（③同期）→WebアプリA（②非同期）→ブラウザというデータフローが実現できます。
まとめ：Spring BootとJSPで未来を切り拓く
本記事では、Spring Bootの高速開発とJSPの既存資産活用を両立させる、WAR形式でのデプロイ戦略を解説しました。JAR形式でのJSP利用の難しさを乗り越え、外部Tomcatを利用することで、安定したJSPベースのUIと、Spring Bootの強力なバックエンド処理を組み合わせることが可能です。
WebアプリA（WAR）とWebアプリB（JAR）という二層構造は、マイクロサービスアーキテクチャの第一歩とも言え、それぞれの責務を明確に分離することで、開発効率とメンテナンス性を高めます。これにより、既存システムを活かしつつ、AI連携のようなモダンな技術を取り入れるDX戦略を強力に推進できるでしょう。
次のステップへ：更なるDX推進のために
この実践ガイドが、あなたのSpring BootとJSPを用いた開発の一助となれば幸いです。次のステップとして、以下を検討してみてはいかがでしょうか。
- 認証・認可の導入: Spring Securityを用いたセキュリティ機能の追加。
- エラーハンドリングの強化: グローバルなエラーハンドリングや、APIのエラーレスポンスの標準化。
- フロントエンド技術の導入: JSPから、ReactやVue.jsといったSPAフレームワークへの移行検討。
- テストコードの拡充: 単体テスト、結合テスト、E2Eテストの導入。
疑問点や更なるご相談があれば、いつでもお声がけください。
この記事が皆様のDX推進とサイトトラフィック増加に貢献することを願っております。
関連情報:
この記事が役に立ったと感じたら、ぜひSNSでのシェアやブックマークをお願いいたします！