Eclipse の 「Web, XML, and Java EE 及びエンタープライズ開発」に関するプラグインのインストール

* 「動的 Web プロジェクトが選べない」というような症状のときは, この Web ページの手順により解決するかも知れません。

重要な事前確認事項 (Tomcat をインストール済みの場合)

Tomcat をインストール済みのときは, Web ツール・プラットホーム (WTP) のインストールの前に, 必ず,下記の点を確認すること.(インストール後にやり直すのは不可能ではないが面倒くさいです)

◆tomcat の設定ファイルである conf/server.xml について

conf/server.xml内にある「port="8080" についての記述」を書き換えていて,Tomcat と 8080 ポートで通信することはできないようにしている可能性がある

まずは,tomcat の設定ファイル(conf\server.xml)を確認すること.

* 【Tomcat と 8080 ポートで通信できる】

    <Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />

* 【Tomcat と 8080 ポートで通信できない (コメントにしているため)】

<--
    <Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />
-->

Tomcat と 8080 ポートで通信することはできないようになっている場合には,次の手順を踏んでください. 通信できるようになっている場合は,何もしなくていいです.

  1. tomcat の設定ファイル(conf\server.xml)を,Tomcat と 8080 ポートで通信できる状態に書き換える
  2. Web ツール・プラットホーム (WTP) のインストールを行う
  3. tomcat の設定ファイル(conf\server.xml)を,Tomcat と 8080 ポートで通信できない状態に戻す

より詳しい説明.

Web ツール・プラットホームを使うと,Eclipse 内部の tomcat サーバが動き, これを,動作テストなどに使えるようになるのですが,この「Eclipse 内部の tomcat サーバ」というのは,公開される tomcat サーバとは別物です. 「Eclipse 内部の tomcat サーバ」は,ポート 8080 を使う.

一方で,公開される tomcat サーバは,セキュリティ上の理由で,ポート 8080 で通信できないように設定する (tomcat の設定ファイル(conf\server.xml)での設定)というのは良くあることです.

ここで問題です, Web ツール・プラットホーム (WTP) のインストールする時点で, 公開される tomcat サーバの設定ファイル(conf\server.xml)がもし存在すれば,この設定内容が, 「Eclipse 内部の tomcat サーバ」に自動的に引き継がれます. したがって, tomcat の設定ファイル(conf\server.xml)を「Tomcat と 8080 ポートで通信することはできない」ような設定のままで Web ツール・プラットホーム (WTP) のインストールを行うと,「Eclipse 内部の tomcat サーバ」がうまく動かない,という症状が現れる.

Java 25(Temurin 25 JDK) のインストール

Eclipse Temurin(Adoptium)のインストールを行い、Javaのプログラムをコンパイル・実行する環境を整える。扱う環境は、Windows搭載パソコンである。現時点(2026年6月)での最新LTS版である Java 25(Temurin 25 JDK)を推奨する。

[Windows での Java 25(Temurin 25 JDK) のインストール手順を見るには、ここをクリック]

Windows での Java 25(Temurin 25 JDK) のインストール

以下のいずれかの方法で Java 25(Temurin 25 JDK)をインストールする。JDKがインストール済みの場合、この手順は不要である。

方法 1:winget によるインストール

インストールコマンドの実行方法

管理者権限コマンドプロンプトを起動する(手順:Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」)。そして、コマンド全体をコマンドプロンプトにコピー&ペーストする。

Temurin の Windows インストーラー(.msi)は、ユーザー単位ではなくマシン単位でインストールされる(1台に1つのインストール)。そのため、システム全体(全ユーザー向け)にインストールするには管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動するとPATHが反映される。

REM Java 25(Temurin 25 JDK) をインストール(PATH と JAVA_HOME を更新)
winget install --id EclipseAdoptium.Temurin.25.JDK -e --silent --accept-source-agreements --accept-package-agreements --override "ADDLOCAL=FeatureMain,FeatureEnvironment,FeatureJarFileRunWith,FeatureJavaHome INSTALLDIR=\"C:\Program Files\Eclipse Adoptium\jdk-25\" /quiet"

上記の --override 内の指定の意味は次のとおりである。FeatureEnvironment はPATH環境変数の更新、FeatureJavaHomeJAVA_HOME 環境変数の更新、FeatureJarFileRunWith は .jar ファイルとJavaアプリケーションの関連付けである。INSTALLDIR はインストール先フォルダの指定である。

方法 2:インストーラーによるインストール

  1. Adoptium公式サイト(https://adoptium.net/temurin/releases/)にアクセスし、Version として「25 - LTS」、Operating System として「Windows」を選び、.msi 形式のWindows用インストーラーをダウンロードする。
  2. ダウンロードした .msi ファイルを実行し、インストールプログラムを起動する。
  3. ライセンス条項を確認し、同意できる場合はチェックを入れて次へ進む。
  4. 「Installation Scope」画面では「Install for all users of this machine」を選ぶ
  5. 「Custom Setup(カスタムセットアップ)」画面で、インストールする機能を選択する。既定では「Add to PATH(PATH環境変数への追加)」と「Associate .jar」(.jarファイルの関連付け)が有効になっている。さらに、ツリー内でバツ印(×)が付いている「Set JAVA_HOME variable(JAVA_HOME環境変数の更新)」をクリックして有効に変更することを推奨する。これらを有効にしないと、コマンドプロンプトから java コマンドを実行できなかったり、開発ツールがJDKを見つけられなかったりする。
  6. 「次へ (Next)」をクリックし、続いて「インストール (Install)」をクリックしてインストールを開始する。完了後「Finish」で閉じる。

インストールの確認

コマンドプロンプトで以下を実行する。

java --version

バージョン番号(例:openjdk 25.x.x)が表示されればインストール成功である。「'java' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していないか、PATHが反映されていない(コマンドプロンプトを再起動して再度確認する)。

あわせて、コンパイラと JAVA_HOME も確認しておくとよい。

javac --version
echo %JAVA_HOME%

Eclipse のインストール

Eclipse をインストールする。扱う環境は、Windows搭載パソコンである。

[Windows での Eclipse のインストール手順を見るには、ここをクリック]

Windows での Eclipse のインストール

以下のいずれかの方法で Java 25(Temurin 25 JDK)をインストールする。JDKがインストール済みの場合、この手順は不要である。

方法 1:winget によるインストール

インストールコマンドの実行方法

管理者権限コマンドプロンプトを起動する(手順:Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」)。そして,コマンド全体をコマンドプロンプトにコピー&ペーストする。

REM Temurin 25 JDK をインストール
winget install --id EclipseAdoptium.Temurin.25.JDK -e --accept-source-agreements --accept-package-agreements

winget が使えない場合や,インストール先・パッケージ種類を画面で選びながら導入したい場合は,次の方法を用いる。

方法 2:インストーラーによるインストール

公式サイトからダウンロードしてインストールできる。詳しくはhttps://www.kkaneko.jp/tools/win/eclipse.htmlで説明している。

Eclipse の初期設定、使用方法の基本

詳しくはhttps://www.kkaneko.jp/tools/win/eclipse.htmlで説明している。

インストール手順

  1. Eclipse の起動
  2. 「ソフトウェア更新」の開始

    ヘルプ (Help)」メニュー → 「新規ソフトウェアのインストール」 を選ぶ

  3. 作業対象として「--すべての使用可能なサイト-- (--All Available Sites--)」を選ぶ
  4. Web, XML, Java EE および OSGi エンタープライズ開発 (Web, XML, and Java EE Development)」をチェックし,「次へ (Next)」をクリック.
  5. インストール詳細の確認

    このままでよいので, 「次へ(Next)」をクリック.

  6. ライセンス条項の確認

    ライセンス条項を確認する

  7. インストールが始まる
  8. Eclipse の再起動