このページでは,既存の Java サーブレットプログラムを,Eclipse に取り込む手順を説明しま す.Eclipse を使ってデバッグしたい,という場合に役立ちます.
Eclipse のプロジェクト名,Java パッケージ名を決めておいてください. これらの名前は自由です. このページでは,次のように記述します.
前もって,Tomcat インストールディレクトリを調べておいてください.
次の手順で, 既存の Java サーブレットプログラムを,Eclipse に取り込む. そのためには,最初に,Eclipse のプロジェクトを作る必要がある.
下記の手順で,動的 Web プロジェクトを新規に作成する.
「ウインドウ (Window)」→「ビューの表示 (Show View)」→「プロジェクト・エクスプローラ (Project Explorer)」 と操作する.
「ファイル」→「新規 (New)」→「プロジェクト (Project)」
または,プロジェクト・エクスプローラ内で,右クリック→「新規 (New)」→「プロジェクト (Project)」
新規プロジェクトのウインドウが開くので, 「Web」を展開する.
展開した「Web」の下にある 「動的 Webプロジェクト (Dynamic Web Project)」を選び, 「次へ」をクリック.
設定用のウインドウが開くので,下記の設定を行う. 設定が終わったら,「次へ」をクリック.
プロジェクト名は,好きな名前でよいが,スペースや全角文字は避けること. ここでは,プロジェクト名を,「HelloWorld」と付けることにする.
「デフォルトの使用 (Use default)」にチェックを入れたままで良い.
他のもの(例えば「なし」)になっていたら,「Apache Tomcat v5.5」に変更しておく
変更のとき,「なし」だけしか無くて,「Apache Tomcat v5.5」が候補として表示されない場合は, 「Eclipse を使用しての Java サーブレット・プログラムの開発」の Web ページに記載の「新規サーバの定義」を行うこと.
「次へ」をクリック.
聞いてこないこともある.
「終了」をクリック.
聞いてこないこともある.
Eclipse のプロジェクト・エクスプローラを使って, Java パッケージを作成します. Java パッケージ名には hoge.hoge.com のようなドメイン名を付ける習慣があることに注意してください. このページでは,作成するJava パッケージ名は,hoge.hoge.com と書く. (Java パッケージ名を変えるときは,読み替えてください).
「ウインドウ」→「ビューの表示」→「プロジェクト・エクスプローラ」 と操作する.
Java パッケージの作成,クラスの作成などの作業は,プロジェクト・エクスプローラで行う.
プロジェクト・エクスプローラに,プロジェクト一覧が表示されているはずです. Java パッケージを新規作成したいプロジェクト名 HelloWorld を右クリックして, 「新規」→「パッケージ」と操作する.
「Java パッケージ (Java package)」の名前は,hoge.hoge.com. 「終了」をクリック.
先ほど作成したJava パッケージ hoge.hoge.com に, 既存の Java サーブレットプログラムのファイルをインポートする.
インポートしたいJava パッケージ名 hoge.hoge.com を右クリック.
「一般」→「ファイルシステム」と操作した後, 「次へ」をクリック
インポートしたいファイルを選び,「終了」をクリック.
例えば,次のようになる.
サーブレットとして使えるようにするためには web.xml を編集する必要がある. 手動で web.xml を編集するのは難しくないのですが, Eclipse の機能を使って,web.xml を自動編集してみる.
外部 JAR の追加が必要かも知れません. 例えば,リレーショナルデータベースと連携させている場合,リレーショナルデータベースと通信するためのプログラム(例えば,JDBC の JAR ファイル)を, 外部 JAR として追加する必要があるでしょう.
Eclipse のプロジェクト・エクスプローラを使用して,上記で作ったJava サーブレットのプログラム をテスト実行してみる.
ウインドウが開くので,「既存のサーバーを選択 (Choose an existing server)」の方をチェックがチェックされていることを確認してから, 「次へ (Next)」をクリック.
「終了」をクリック.
すでに,C:\tomcat55\bin\tomcat5w.exe などを使って,「公開 Tomcat サーバを稼働させている」ときは, Eclipse 内部の Tomcat サーバが起動しない(ポートを奪い合うので)ので, C:\tomcat55\bin\tomcat5w.exe を使って, 公開 Tomcat サーバを停止させて下さい.
コンソール・ビューに表示される.
Eclipse の 組み込み Web ブラウザ (Internal Web ブラウザ)が開き,そこに実行結果が出る.
実行で,エラーが出る場合,
C:\tomcat55\bin\tomcat5w.exe を実行してみる. サーバが stop できる状態(STOP ボタンが有効になっている状態)になって いたら,「公開 Tomcat サーバを稼働させている」ということなので, エラーが出て当然. STOP ボタンを押して,公開 Tomcat サーバを停止し,もう1度,上記の操作を行う.
それでもうまく動かない場合は,Eclipse を再起動してみる.