Eclipse 上で作成した Java サーブレット・プログラムプログラムをエクスポート

Eclipse を使って開発した Java サーブレット・プログラムについて,エクスポートを行い,公開 Tomcat サーバ上で,Java サーブレット・プログラムが動くようにします. このとき,Eclipse のプロジェクト内のファイル一式が, 公開 Tomcat サーバが管理するディレクトリの配下にコピーされます.

Eclipse を使用しての Java のサーブレット・プログラムの開発手順などは, 「Eclipse を使用しての Java サーブレット・プログラムの開発」の Web ページで説明している.

前準備

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で説明している。

その他

設定項目

前もって,Tomcat インストールディレクトリを調べておいてください.

 

このページでは次のように書く.

Tomcat プログラムをエクスポート

まず、Eclipse のエクスポート (Export) 機能を利用して、エクスポートを行う.
  1. プロジェクト・エクスプローラで,先ほど作ったプロジェクト を右クリック.「エクスポート」を選択(ファイル→エクスポートでも良い) o
  2. WAR ファイル」を選ぶ
  3. ファイル名等の指定

    WARエクスポートダイアログで,次のように指定する.

     Webモジュール:「<作成済みのプロジェクト名>」
     宛先:「C:\tomcat55\webapps\<好きな名前>.war」
    

     「ソースファイルのエクスポート」→チェック

     「既存ファイルを上書き」→チェック

    「完了」をクリックすると,エクスポートが実行される

  4. WAR ファイルの確認

    /var/lib/tomcat6/webapps/ 下に,拡張子 .war が付いたファイルができる.

  5. 動作確認

    公開 Tomcat サーバを起動した後に, 普通の Web ブラウザで,

    http://localhost:8080/<好きな名前>/HelloWorld
    

    を開くと、Hello World と表示されます. 「<好きな名前>」と書いているのは、先ほどエクスポートするときに付けた 名前です(.war ファイルのファイル名のこと). hoge.war なら、 http://localhost:8080/hoge/HelloWorld

    8080 ポートを使い、公開 tomcat サーバと直接通信しているということに注意.

  6. Apache 側の conf/extra/httpd-proxy.conf の設定

    URL の中に、8080 と書かずに、普通の URL で Servlet を起動できるように するには、Apache のような Web サーバと連携させるのが普通です. そのために、 httpd-proxy.conf ファイルでの設定などを行う必要がある.

    httpd-proxy.conf は、以下のように設定します. Order と Allow の行は、「127.0.0.1」からのアクセスだけを許すという設定です.

    <Location /<エクスポートするプロジェクト名>/>
        ProxyPass ajp://localhost:8009/<エクスポートするプロジェクト名>/
        Order allow,deny
        Allow from 127.0.0.1
    </Location>
    
  7. Apache を再起動

    conf/extra/httpd-proxy.conf を書き換えたから.

  8. Apache での動作確認 

    URL は次の通り

    • Apache サーバ経由でサーブレットに接続:

      (http://localhost/<エクスポートするプロジェクト名>/クラス名) または, (http://localhost/<エクスポートするプロジェクト名>/JSPファイル名.jsp)

    Strutsを使っている場合,ページ遷移すると, http://localhost/<プロジェクト名>/アクション名.do のような URL が現れることを確認しておく.(つまり,http://localhost/<プロジェクト名>/アクション名.do と打ち込むことで,一種の単体テストが出来る)

(参考) Eclipse のエクスポート (Export) 機能を利用しないで,手順でエクスポートする場合

  1. /var/lib/tomcat6/webapps/(プロジェクト名) のディレクトリを作成
  2. /var/lib/tomcat6/webapps/(プロジェクト名)/WEB-INF のディレクトリを作成
  3. eclipseのプロジェクトから以下のものを指定のディレクトリにコピー
     classesディレクトリ → /var/lib/tomcat6/webapps/プロジェクト名/WEB-INF
     web.xml     → /var/lib/tomcat6/webapps/プロジェクト名/WEB-INF
    
  4. /var/lib/tomcat6/conf/server.xmlの確認

    <Context path="プロジェクト名" (以下略)>がある場合コメントアウトか削除

  5. 公開 tomcat サーバの起動

    C:\tomcat55\binディレクトリにある tomcat5w.exe を使う. (Eclipse 内部の tomcat サーバと混同しないこと.別ものです).

  6. apache起動
  7. 作成したwebページが80ポートで見れるか確認