【Javaの基礎知識】Eclipse＋TomcatでWeb開発環境を構築！

2025年2月28日

JavaでWebアプリ開発を始めるには、まずEclipseで動的Web環境を構築する必要があります。本記事では、EclipseのインストールからTomcatの設定、Servlet/JSPの動作確認までを初心者向けにわかりやすく解説します。

また、Javaのプロジェクト管理ツールであるMavenにも触れ、Mavenを使う場合と使わない場合の環境構築の違いについても解説します。手動でライブラリを管理する方法と、Mavenを活用して依存関係を自動管理する方法を理解し、自分に合った開発環境を選びましょう。

「Mavenを使わなくても、JavaのWeb開発はできます！」
「この記事では、Mavenを使う場合と使わない場合の両方を紹介しますが、最初はMavenなしでも問題ありません！」

必要な環境のセットアップ
Eclipse に Tomcat を設定する手順【2025年3月最新版】
Mavenとは？初心者向けにわかりやすく解説！
- Mavenを使うと何が便利なの？
- Mavenは初心者にも必要？
開発環境の構築（Mavenあり/なし）
まとめ
- 本記事のポイント

必要な環境のセットアップ

これらのツールをインストールし、EclipseでTomcatをセットアップすることで、Todoアプリの開発環境を整えることができます。

Eclipseのインストール方法（JDK含む）

JDKおよびEclipseのインストールについては、下記の記事を参照してください。

Beエンジニア

【Javaの基礎知識】JDKとEclipseの導入方法を徹底解説！

https://www.pmi-sfbac.org/java-environment-ide

Javaプログラミングを始めるには、まず JDK（Java Development Kit）と Eclipse の導入が必要です。本記事では、JDKとEclipseの基本知識からインストール手順、環境設定までを初心者向けに詳しく解説します。Java開発環境をスムーズに構築し、プログラミングを始める準備を整えましょう。Java開発に必要な環境とは？ Javaの開発環境を整えるには、JDK（Java Development Kit）とEclipse（統合開発環境）の導入が必須です。ここでは、それぞれの役割や関係性について解説します。JDKとは？JDK（Java Development Kit）は、Javaアプリケ...

Apache Tomcatのインストール方法（Eclipse用）

Tomcatは、JavaのServlet/JSPを実行するためのWebサーバーです。ここでは、Windows & macOS 向けに、EclipseにTomcatを導入する方法を解説します。

Tomcatのバージョンごとの違い

今回は最新（2025年2月27日現在）の推奨版「Tomcat 10.1.x」を使用します。

バージョン	対応Javaバージョン	特徴・用途	推奨度
Tomcat 8.5	Java 7 / 8	旧世代の安定版。レガシー環境向け	❌（古い）
Tomcat 9	Java 8 / 11 / 17	Java EE 8（Jakarta EE 8）準拠。現在も広く使われている	✅ （推奨）
Tomcat 10.0	Java 8 / 11	Jakarta EE 9 に対応（ただし仕様変更が大きい）	❌（移行向け）
Tomcat 10.1	Java 11 / 17 / 21	Jakarta EE 10 準拠で最新の仕様	✅ （最新の推奨版）

Eclipse に Tomcat を設定する手順【2025年3月最新版】

本記事では、Eclipse に Tomcat を正しく設定し、確実に動作させる方法を解説します。従来の手順ではうまく動作しないケースがあったため、最適化した手順を紹介します。

Tomcat のダウンロードとインストール

まず、Apache Tomcat の公式サイトから最新版をダウンロードし、適切なディレクトリに解凍します。

公式サイト: Apache Tomcat 10 ダウンロード
推奨バージョン: Tomcat 10.1
解凍場所: /Users/ユーザー名/Work/Java/apache-tomcat-10.1.xx/ など

Eclipse に Tomcat を追加

Eclipse に Tomcat を登録する手順は以下の通りです。

🔹 まず「サーバービュー」を表示

「サーバー」ビューが表示されていない場合は、以下の手順で表示してください。

メニューの「ウィンドウ」→「ビューの表示」→「サーバー」 を選択
「サーバービュー」が表示されたことを確認

🔹 Tomcat の登録手順

「サーバー」ビューで右クリック → 「新規」→ 「サーバー」 を選択
「Apache」→「Tomcat v10.1 サーバー」 を選択し、下記を指定
サーバー名：「Tomcat10（Java17）」または「Tomcat10（Java21）」
サーバー・ランタイム環境：「Tomcat10（Java21）」を選択
「ランタイム環境の構成」リンクをクリック
「サーバー・ランタイム環境」画面で「JRE は Java 17 or 21 」を選択し、「編集」ボタンをクリック
「サーバ・ランタイム環境の編集」画面で下記を入力する。
名前：「Tomcat10（Java21）」
Tomcatインストール・ディレクトリ：「Tomcat格納ディレクトリを指定」
JRE:「Java21」
「完了」ボタンをクリック
サーバービューの中にTomcat10_Java21（2025年3月時点で最新）があることを確認します。

動的 Web プロジェクトの作成

ブラウザへ動的なアプリケーションを作成する想定のため、動的プロジェクトを作成します。

Tomcat サーバ用プロジェクトの作成

Eclipseのメニューバーの「ファイル」から「新規」を選択し「その他」とクリック
「web」を開いて「動的Webプロジェクト」を選択し、「次へ」をクリック
「プロジェクト名」と「ターゲット・ランタイム」を入力して「次へ」をクリック
プロジェクト名：「JavaStudy（任意の名前）」
ターゲット・ランタイム：「Tomcat10（java21）」
特に何も設定はせずに、そのまま「次へ」をクリック
「web.xmlデプロイメント記述子の生成」のチェックが入ってることを確認し、「完了」をクリック
プロジェクトが作成されていることを確認

ライブラリの追加

作成されたプロジェクトを右クリックし、「プロパティー」を選択
左側のエリアで「Javaのビルド・パス」を選択し、「ライブラリー」タブを選択
「モジュールパス」を選択したまま「外部JARの追加」ボタンをクリック
ファイル選択画面で、下記フォルダーの中から必要なAPIを選択し、「開く」をクリック
ライブラリ：「<<i nstall_dir >>/apache-tomcat-10.1.36/lib」※ Tomcatをインストールしたディレクトリ配下
・JARファイルを任意で選択（今回は「servlet-api.jar」「jsp-api.jar」を選択しています）
選択したファイルが追加されていることを確認し、「適用して閉じる」をクリック

用途	ライブラリ名	必要度
Servlet API	javax.servlet-api.jar（Tomcat10は jakarta.servlet-api.jar）	⭐⭐⭐⭐⭐（必須）
JSP API	javax.servlet.jsp-api.jar（Tomcat10は jakarta.servlet.jsp-api.jar）	⭐⭐⭐⭐（JSPを使うなら必須）
JSTL	jakarta.servlet.jsp.jstl-api.jar	⭐⭐⭐（JSPを便利にするなら）
JDBCドライバ	mysql-connector-java.jar（MySQL用）	⭐⭐⭐（DBを使うなら）
JSONライブラリ	jackson-databind.jar	⭐⭐（APIでJSONを使うなら）

Eclipse で Tomcat を起動

ここまでの設定が完了したら、起動テスト用のサンプルJSPファイルを作成してTomcatの起動確認を行います。

作成した「JavaStudy」プロジェクトを右クリックし、「新規」=> 「JSPファイル」をクリック
「JSP作成」画面で「JavaStudy/src/main/webapp/」が選択されている状態で、JSPファイル名を入力
ファイル名：「hello.jsp」
「JSPテンプレートの選択」画面で「新規JSP（html 5）が選択されている状態で「完了」をクリック
「プロジェクト」画面で「JavaStudy/src/main/webapp/」配下に「hello.jsp」が作成されていることを確認
Tomcatの起動確認用に「hello.jsp」ないのコードを編集
編集するコードは「JSP編集コード」参照
「プロジェクト」画面で対象JSPファイルを選択し、右クリック後、「実行」=> 「1.サーバーで実行」を選択
初回起動時には下記の警告が出力されることがあります。
チェックを入れて「保存」をクリック（任意）
「サーバーの実行」画面が表示されたら「サーバ」リストないの「Tomcat_Java21」を選択し、「次へ」をクリック
「追加および除去」画面で「構成済み」リストに「JavaStudy」が表示されていることを確認して「完了」ボタンをクリック
Tomcatが起動され「ログ出力」画面へログが出力されていることを確認
ブラウザで「 http://localhost:8080/」にアクセスし、Tomcat の管理画面が表示されることを確認

ブラウザに「Hello、JSP！」と表示されれば、Tomcatは正常に稼働しています。

JSP編集コード

新規作成された「hello.jsp」ファイルのコードを下記コードへ書き換えてください。

[hello.jsp]

<%@ page contentType="text/html; charset=UTF-8" language="java" %>
<!DOCTYPE html>
<html lang="ja">
<head>
   <meta charset="UTF-8">
   <title>Hello JSP</title>
</head>
<body>
   <h1>Hello, JSP!</h1>
   <p>現在の時刻：<%= new java.util.Date() %></p>
</body>
</html>

EclipseでTomcatの停止

Tomcatを停止する場合は、「サーバ」画面から対象のTomcatを選択し「◾︎」ボタンをクリックor右クリックで「停止」を選択

よくあるエラーと対策

EclipseでTomcatを設定して動的Webプロジェクトを作成する際、環境によってさまざまなエラーが発生することがあります。本章では、EclipseとTomcatの組み合わせでよく遭遇するエラーとその対策について解説します。

エラー内容	原因	対策
「ポート 8080 は既に使用中です」	他のプロセスが 8080 ポートを使用している	ターミナルで lsof -i :8080 を実行し、競合プロセスを終了
「ワークスペースのメタデータを使用」のままになっている	Tomcat のロケーション設定が間違っている	「サーバーのロケーション」タブで「Tomcat のインストールを使用」に変更
「HTTP ステータス 404 - 見つかりません」	デプロイが正しく行われていない	「デプロイ・パス」を webapps に設定し直す

Mavenとは？初心者向けにわかりやすく解説！

Maven（メイヴン）とは、Javaのプロジェクト管理とビルドを自動化するツール です。通常、Javaのプロジェクトを作るときは以下のような作業が必要になります。

✅ ライブラリ（JARファイル）の追加・管理
✅ コンパイル・ビルド（プログラムを実行可能な形にする）
✅ テストの実行
✅ WebアプリをWARファイルにまとめる
✅ Tomcatなどのサーバーにデプロイする

Mavenを使うと、これらの作業を自動化 できます！

Mavenを使うと何が便利なの？

✅ 1. ライブラリの管理が自動化される

通常、プロジェクトで使うライブラリ（ servlet-api.jar など）は、自分でダウンロードして lib/ に配置しないといけません。

Mavenを使えば、必要なライブラリを pom.xml という設定ファイルに書くだけ で、自動的にインターネットから取得してくれます！

<dependency>
   <groupId>jakarta.servlet</groupId>
   <artifactId>jakarta.servlet-api</artifactId>
   <version>5.0.0</version>
   <scope>provided</scope>
</dependency>

✅ 2. プロジェクトの構成が統一される

Mavenを使うと、プロジェクトのディレクトリ構成が統一されます。

ディレクトリ	役割
src/main/java/	Javaのソースコード
src/main/webapp/	WebアプリのJSPやHTML
src/test/java/	テスト用コード
target/	コンパイル後の成果物（WAR/JAR）

✅ 3. ビルドやデプロイが簡単になる

Mavenには 「ビルド」や「Tomcatにデプロイ」する機能 もあります。

通常は、手動でコンパイルして WAR ファイルを作って Tomcat に配置しますが、Mavenなら 1コマンドで完了！

mvn package # WARファイルを作成
mvn tomcat:deploy # Tomcatにデプロイ

Mavenは初心者にも必要？

Mavenを使うと 「環境構築やライブラリ管理が楽になる」 というメリットがありますが、
最初は「Mavenなし」でも十分に開発できます！

📌 Mavenを使うべきか？

項目	Mavenなし	Mavenあり
セットアップの手間	手動でライブラリを追加	Mavenで自動管理
ディレクトリ構成	自由度が高い	標準化された構成
依存関係の管理	手動（手間がかかる）	自動（簡単）

初心者には「Mavenなし」が分かりやすいですが、将来的にフレームワークを活用するなら「Mavenあり」の方が便利です。

✅ Mavenは Javaのプロジェクト管理＆ビルドを自動化するツール
✅ ライブラリ管理、ビルド、デプロイが簡単になる
✅ 初心者はまず「Mavenなし」で開発し、必要になったらMavenを学ぶのがオススメ！

開発環境の構築（Mavenあり/なし）

JavaのWebアプリ開発では、EclipseとTomcatの組み合わせが一般的ですが、プロジェクトの管理方法には「Mavenを使用する場合」と「Mavenを使わない場合」の2通りがあります。本章では、それぞれの開発環境の違いやセットアップ方法を解説し、どちらを選ぶべきかの判断基準も紹介します。あなたの開発スタイルに合った環境を構築し、スムーズにプロジェクトを進めましょう。

Eclipse + Tomcatのセットアップ（Mavenなしの場合）

ここでは、Mavenを使わずにEclipseとTomcatを組み合わせた開発環境を構築する方法を解説します。Mavenなしの場合、手動でライブラリを管理し、プロジェクトの構成がシンプルになるのが特徴です。

Eclipse + Tomcat のセットアップ（Mavenあり）

本記事では、Mavenを使用して Eclipse + Tomcat の環境をセットアップする方法を解説します。Mavenを利用することで、依存関係の管理が容易になり、プロジェクトの構成がシンプルになります。

1. 必要な環境

以下の環境を準備してください。

項目	バージョン
JDK	Java 17 または Java 21
Eclipse	最新の Eclipse IDE for Enterprise Java Developers
Apache Tomcat	Tomcat 10
Maven	Apache Maven 3.8 以上

2. Mavenのインストール

公式サイトからMavenをダウンロードし、環境変数に追加します。

wget https://downloads.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz
tar -xvzf apache-maven-3.8.6-bin.tar.gz
export PATH=/path/to/apache-maven-3.8.6/bin:$PATH

3. EclipseでMavenプロジェクトを作成

Eclipseで以下の手順を実施してください。

1. 新規Mavenプロジェクトの作成

[File] → [New] → [Maven Project] を選択
「Create a simple project」にチェックを入れて [Next]
Group ID と Artifact ID を設定（例: com.example）
[Finish] をクリック

2. pom.xml の設定

プロジェクト直下の pom.xml を開き、以下のように設定します。

<dependencies>
  <dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-core</artifactId>
    <version>10.1.0</version>
  </dependency>
</dependencies>

3. Tomcatの設定

Eclipseの [Window] → [Preferences] を開く
[Server] → [Runtime Environments] を選択
[Add] → [Apache Tomcat] を選択し、Tomcatのインストールディレクトリを指定
[Finish] をクリック

4. サーバーの起動と確認

サーバーを起動し、動作を確認します。

1. Tomcatの起動

Eclipseの [Servers] タブから、Tomcat を右クリックし [Start] を選択

2. 確認

ブラウザで http://localhost:8080 にアクセスし、Tomcatの管理画面が表示されることを確認

5. よくあるエラーと対策

エラー	対策
Tomcat が起動しない	ポート 8080 が使用中の可能性。 server.xml を編集してポートを変更
Maven の依存関係が解決しない	Eclipse の [Project] → [Update Maven Project] を実行

これで、Eclipse + Tomcat（Mavenあり）の環境が構築できました。

ディレクトリ構成（プロジェクトの基本構造）

プロジェクトのディレクトリ構成は、Mavenを使用するかどうかによって異なります。まず、どのような違いがあるのかを理解しましょう。

構成	Mavenなし	Mavenあり
ソースコード	src/	src/main/java/
Webアプリのルート	WebContent/	src/main/webapp/
設定ファイル	手動で配置	pom.xml で管理

📌 Eclipse 2024-12 では、Maven なしでも「src/main/webapp/ 」がデフォルトに！
Eclipse 2024-12 では、Dynamic Web Module のバージョンが 6.0 以上になると、Maven なしでも「WebContent/」ではなく「src/main/webapp/ 」がデフォルトになります。

バージョン確認方法

プロジェクトを右クリック → [プロパティ] → [Project Facets] を開く
Dynamic Web Module のバージョンが 6.0 以上なら src/main/webapp/ がデフォルト
WebContent/ に戻したい場合は [Deployment Assembly] から手動変更可能！

Mavenを使ったプロジェクト管理（Mavenありの場合）

Mavenを使うと、依存関係の管理が自動化され、ディレクトリ構成が統一されます。Tomcatなどのサーバー設定も、Mavenプラグインを利用して自動化できます。

org.apache.tomcat
tomcat-servlet-api
10.0.20
provided

Mavenなし vs ありの違い（どちらを選ぶべきか？）

初心者にとって、どちらの開発環境が適しているのかを比較します。

項目	Mavenなし	Mavenあり
セットアップの手間	手動でライブラリを追加	Mavenで自動管理
ディレクトリ構成	自由度が高い	標準化された構成
依存関係の管理	手動（手間がかかる）	自動（簡単）

初心者のうちは「Mavenなし」が分かりやすいですが、将来的にフレームワークを活用するなら「Mavenあり」の方が便利です。実際のプロジェクトでは「Maven」の知識は必須になります。

まとめ

Eclipse + Tomcat の開発環境を Maven を使って構築することで、依存関係の管理やプロジェクト構成の管理が簡単になり、スムーズに開発を進めることができます。 本記事では、Eclipse に Tomcat を設定し、Maven プロジェクトを作成する手順を解説しました。

本記事のポイント

必要な環境を準備（JDK、Eclipse、Tomcat、Maven）
Maven をインストールし、環境変数を設定
Eclipse で新規 Maven プロジェクトを作成
pom.xml に Tomcat の依存関係を追加
Eclipse に Tomcat を設定し、プロジェクトをデプロイ
Tomcat を起動し、ブラウザで動作確認
よくあるエラーと対策を紹介

Maven を活用すると、今後 Spring Boot に移行する際にもスムーズに開発を進めることができます。 もしエラーが発生した場合は、Maven のビルドや Tomcat の設定を見直してみてください。

よく読まれている記事

1: 【IT入門】シェルとシェルスクリプトの違いとは？シェルの種類について
IT入門シリーズ 🟢 STEP 1: ITの基礎を知る（ITとは何か？）├─【IT入門】ITとは？仕組みや活用方法をわかりやすく解説├─【IT入門】インターネットとは？仕組み・使い方を ...

2: 【Linuxの基礎知識】Linuxとは？基本概要と仕組みをわかりやすく解説！
「私たちが日々利用しているスマートフォンやインターネット、そしてスーパーコンピュータやクラウドサービス――これらの多くがLinuxの力で動いていることをご存じですか？無料で使えるだけでなく、高い柔軟性 ...

3: 【Shellの基礎知識】Shellスクリプト入門｜初心者が押さえる基本
Shellスクリプト基礎知識（全13記事+2） ├─【Shellの基礎知識】Shellスクリプト入門｜初心者が押さえる基本├─【Shellの基礎知識】変数と特殊変数の使い方｜初心者向け解説├─【She ...

-Java の基礎知識

【Javaの基礎知識】変数、リテラル、基本データ型について解説！

Javaは、世界中で広く使われているプログラミング言語のひとつです。プログラムを作成する上で、「変数」「データ型」「演算子」の理解は欠かせません。本記事では、初心者でも分かりやすいように、Eclipse上で実行できるシンプルなコードを使いながら、これらの基礎を解説します。もくじ Javaの基本概念Javaとは？Javaの特徴本記事で解説するJavaの基礎変数の基礎変数とは？Javaの変数の種類変数の宣言と代入変数名（識別子）変数を使ってみようデータ型の基礎プリミティブ型（基本データ型）int型と他の ...

【Javaの基礎知識】ファイル操作の基本！入出力処理を徹底解説

ファイル操作はJavaのプログラミングにおいて避けて通れない重要な技術です。本記事では、ファイルの読み書きやストリームの基本をわかりやすく解説します。初心者でも実践できるコードサンプルを交えながら、効率的な入出力処理をマスターしましょう！もくじ Javaのファイル操作とは？ファイル操作の基本概念 Javaでファイルを操作するメリット Javaのファイル操作の使い所設定ファイルの読み書きログ管理データの永続化バックアップ処理バッチ処理・データ集計ファイルの自動生成ネットワーク通信の補助 J ...

【Javaの基礎知識】最小限の機能で作るJavaFXテキストエディタ

JavaFXを使って、シンプルなエディタアプリを作成する方法を解説します。本記事では、基本的なUI設計からイベント処理の実装まで、実践的なステップを詳しく説明します。初心者でも理解しやすいように、コード付きで解説しているので、ぜひ参考にしてください。もくじエディタアプリの概要本アプリの目的エディタとして実現する機能一覧操作性とUIの要件エディタアプリの全体設計書の構成と設計要素設計方針アプリの主要コンポーネントファイル管理とユーザー設定エディタアプリの使用する全クラス一覧エディタアプリの実装手順メ ...

【Javaの基礎知識】List・Set・Mapの基本と活用法を解説！

Javaではデータを扱う方法として、配列（Array）とコレクション（List・Set・Map）の2つがあります。配列はシンプルで高速ですが、サイズ固定のため扱いにくい場面もあります。一方、コレクションは柔軟にデータを管理できるため、現在のJava開発では主流になっています。本記事では、配列の基本から List、Set、Map の使い方までを詳しく解説し、それぞれの違いと適切な選択方法についても説明します。もくじ Javaのコレクションフレームワークとは？コレクションとは？配列（Array）の基本 ...

【Javaプログラム】文字列の作成方法とStringのメソッドについて！

前回は変数の使い方や基本データ型について学習しました。今回はその中でちらっと出てきた「String型」についての解説になります。String型は基本データ型ではありませんが、int型と並んでよく使うデータ型なので、ここで基本を押さえておきましょう！もくじ文字列はオブジェクトとして扱うnew演算子でオブジェクトを生成するメソッドを実行してみる文字列の長さを取得・length()文字を抜き出す・charAt()空かどうかを調べる・isEmpty()全て小文字にする・toLowerCase()文字列を抜き ...

【Javaの基礎知識】ファイル操作の基本！入出力処理を徹底解説

【Javaの基礎知識】Servlet/JSPでTodoアプリを作ろう