MavenでJakarta EEプロジェクトを作る基本手順を完全ガイド！初心者でもわかる構成と設定

1. Mavenとは？Jakarta EEとの関係

1. Mavenとは？Jakarta EEとの関係

Maven（メイヴン）は、JavaやJakarta EEなどのプロジェクトを構築・管理するためのビルドツールです。Jakarta EEのWebアプリケーションを開発するとき、依存ライブラリの管理やディレクトリ構成の統一、WARファイルの自動生成などに使われます。

Jakarta EEプロジェクトでは、Mavenを使うことでServlet APIやJSP APIなどの依存を簡単に追加でき、開発の効率が格段に上がります。

2. Jakarta EEプロジェクトの作成手順（Maven使用）

2. Jakarta EEプロジェクトの作成手順（Maven使用）

それでは、実際にMavenでJakarta EEプロジェクトを作成する手順を紹介します。以下の手順で構成していきましょう。

• 1. Mavenインストールの確認
• 2. プロジェクトの雛形作成
• 3. pom.xmlの設定
• 4. ディレクトリ構成の確認
• 5. Jakarta EE依存の追加
• 6. サーブレットなどの作成
• 7. WARファイルのビルド
• 8. PayaraやWildFlyでのデプロイ

3. Mavenインストールと確認方法

3. Mavenインストールと確認方法

まずはMavenがインストールされているか確認しましょう。以下のコマンドでバージョン情報が表示されればOKです。

mvn -v

もしMavenがインストールされていない場合は、公式サイトから最新版をダウンロードし、環境変数PATHに追加してください。

4. MavenでJakarta EEプロジェクトの雛形を作る

4. MavenでJakarta EEプロジェクトの雛形を作る

Mavenのarchetypeコマンドを使えば、基本構成を自動生成できます。

mvn archetype:generate -DgroupId=com.example \
    -DartifactId=jakartaee-webapp \
    -DarchetypeArtifactId=maven-archetype-webapp \
    -DinteractiveMode=false

このコマンドを実行すると、Jakarta EE Webアプリケーションのテンプレートが生成されます。

5. Jakarta EE依存ライブラリの追加

5. Jakarta EE依存ライブラリの追加

次にpom.xmlを編集して、Jakarta EE用のライブラリを追加します。

<dependencies>
    <dependency>
        <groupId>jakarta.platform</groupId>
        <artifactId>jakarta.jakartaee-web-api</artifactId>
        <version>10.0.0</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

scopeをprovidedにすることで、サーバーに既にあるライブラリを使用するよう設定できます。

6. ディレクトリ構成の確認

6. ディレクトリ構成の確認

作成されたMavenプロジェクトは以下のような構成になります。

jakartaee-webapp/
├── src/
│   ├── main/
│   │   ├── java/          // Javaクラス
│   │   ├── resources/     // 設定ファイル
│   │   └── webapp/        // JSPやHTML
│   └── test/
│       └── java/          // テストコード
├── pom.xml                // Maven設定ファイル

src/main/webappにWEB-INFディレクトリやweb.xmlを配置し、ServletやJSPのルーティング設定を行います。

7. Jakarta EEサーブレットの作成例

7. Jakarta EEサーブレットの作成例

次に、Javaクラスとして簡単なサーブレットを作成します。

package com.example;

import jakarta.servlet.*;
import jakarta.servlet.http.*;
import java.io.IOException;

public class HelloServlet extends HttpServlet {
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        response.getWriter().println("Hello from Jakarta EE!");
    }
}

このサーブレットをweb.xmlでマッピングすることで、ブラウザからアクセスできるようになります。

8. WARファイルのビルドとデプロイ

8. WARファイルのビルドとデプロイ

プロジェクトのルートディレクトリで以下のコマンドを実行すると、WARファイルがtargetディレクトリに生成されます。

mvn clean package

生成されたjakartaee-webapp.warファイルを、Payara ServerやWildFlyなどのJakarta EE対応アプリケーションサーバーにデプロイすれば、Webアプリケーションとして動作します。

9. Jakarta EE × Mavenを使うメリット

9. Jakarta EE × Mavenを使うメリット

Jakarta EEとMavenを組み合わせることで、以下のようなメリットがあります：

• ビルドやテストの自動化
• 依存ライブラリのバージョン管理
• チーム開発時の構成統一
• CI/CDパイプラインへの連携も容易

Jakarta EE初心者にとっても、Mavenを使うことでプロジェクト全体を把握しやすくなり、トラブルも少なくなります。

まとめ

まとめ

今回の記事では、Mavenを使ってJakarta EEプロジェクトを構築するための流れを、初心者にも理解しやすい形で整理しました。実際の現場でも、Jakarta EEによるWebアプリケーション開発ではMavenがほぼ必ず利用され、依存関係の管理やWARファイルの生成が効率よく行えることで開発スピードが大きく向上します。とくに、Jakarta EEのように多くのAPIやライブラリを扱う環境では、pom.xmlで依存を記述するだけで必要なライブラリが揃う仕組みが非常に便利で、作業ミスを減らしながら安定したプロジェクト構成を保つことができます。 さらに、Mavenによるプロジェクト雛形生成、標準化されたディレクトリ構成、Jakarta EE APIの追加方法、サーブレットの実装例、WARファイルの生成からアプリケーションサーバーへのデプロイまでの一連の流れを理解することで、Jakarta EE開発の基礎がしっかりと身につきます。特に、Jakarta EEでは多層的な処理が関わるため、プロジェクトの型がきちんと整っているだけで開発が非常に進めやすくなります。 Mavenは単なるビルドツールにとどまらず、バージョン管理やプラグイン拡張、CI/CDとの連携など、現代のWebアプリケーション開発に欠かせない役割を担っています。そのため、今回学んだ内容はJakarta EEに限らず、さまざまなJava開発でも応用でき、将来的に大規模なプロジェクトに参加する際にも非常に役立つスキルになります。ここでは理解を深めるため、記事で紹介した内容に沿って簡単なサンプルコードをあらためて記載します。

サンプルプログラム：pom.xmlでJakarta EE依存を追加した例

<dependencies>
    <dependency>
        <groupId>jakarta.platform</groupId>
        <artifactId>jakarta.jakartaee-web-api</artifactId>
        <version>10.0.0</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

サンプルプログラム：簡単なJakarta サーブレットの例

package com.example;

import jakarta.servlet.*;
import jakarta.servlet.http.*;
import java.io.IOException;

public class SampleServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws IOException {
        response.setContentType("text/html; charset=UTF-8");
        response.getWriter().println("<h2>MavenとJakarta EEで作ったサーブレットです！</h2>");
    }
}

このように、プロジェクトの型を整え、pom.xmlに正しい依存を記述し、サーブレットを配置すれば、Jakarta EEのWebアプリケーションは動作します。Mavenを用いることで設定内容が明確になり、チーム開発でも統一した形で作業できるため、非常に強力な開発基盤を構築できます。さらに、MavenはPayaraやWildFlyなどのアプリケーションサーバーとの相性も良く、プラグインを使用すれば自動デプロイの環境整備も容易です。 本記事の流れを踏まえてプロジェクト作成を自分の手で行うことで、Jakarta EEのディレクトリ構成、依存追加、サーブレット実行などの理解が一段と深まります。最初は複雑に見えるかもしれませんが、一つひとつの手順に意味があり、それらが積み重なることで大規模開発にも耐えられる堅牢なアプリケーションが作れるようになります。ぜひ実際にMavenコマンドを打ちながら、Jakarta EEプロジェクトの構築を体験してみてください。