環境構築2「動的Webプロジェクト in Eclipse + Maven 編」

2010/04/07追記 このページは2009/06/23に書かれた古い情報です。
更新版→http://d.hatena.ne.jp/grachro/20100407







目的:Eclipse上でTomcatを起動させ、新規作成したプロジェクトのファイルをブラウザ上で表示させる


以下、環境構築1「Eclipse + Mavenプラグイン編」が完了していることが前提です。


プロジェクト作成の前に、Tomcatをインストールしておきます。
Tomcatのインストール
サイト:http://tomcat.apache.org/

  1. Tomcat5.5をダウンロード
  2. ダウンロードしたファイルを任意の場所で解凍

※以降は、C:\apache-tomcatに解凍したものとして記述します


EclipseTomcatサーバの設定
引き続き起動中のEclipse上の操作です

  1. 「ウィンドウ」メニュー > 「設定」メニュー > 「サーバ」メニュー > 「ランタイム環境メニュー」
  2. 「追加」ボタン > 「Apache Tomcat 5.5」を選択 > 「次へ」ボタン
  3. Tomcat インストール・ディレクトリ」に"C:\apache-tomcat"を記述


Eclipseで新規プロジェクトの作成

  1. Eclipseのプロジェクトエクスプローラ上で右クリック
  2. 「新規」メニュー > 「動的 Webプロジェクト」を選択(メニューに無ければ「その他」を選択して一覧から探す) > 新規ダイアログが開く
  3. 最初の「動的Webプロジェクト」画面で
    1. プロジェクト名を入力(以下、"mockapp"と入力した前提で記述します。)
    2. 「ターゲットランタイム」に「Apache Tomcat 5.5」が選択されていることを確認
    3. 「動的Webモジュールバージョン」に「2.4」が選択されていることを確認
    4. 「構成」に「Apache Tomcat 5.5 ディフォルト構成」が選択されていることを確認
    5. 「次へ」ボタンをクリック
  4. 次の「Webモジュール」画面で
    1. 「コンテキスト・ルート」に"mockapp"が設定されていることを確認
    2. 「コンテンツ・ディレクトリー」を"WebContent"から"src/main/webapp"に変更
    3. Java ソース・ディレクトリー」を"src"から"src/main/java"に変更
    4. 「完了」ボタンをクリック

EclipseMavenを使う場合、新規プロジェクト作成でMavenプラグイン由来の構成を選ぶこともできますが、ここではEclipseディフォルトの「動的Webプロジェクト」を作成し、あとからMavanに依存させています。
※コンテンツ・ディレクトリーを変更しているのは、Mavenの「maven-archetype-webapp」で作成されるディレクトリ構造に準拠させるためです。

これで新規の「動的 Webプロジェクト」が作成されます。
「動的 Webプロジェクト」で作成すると、アプリケーションサーバ(この例ではTomcat)の起動がEclipse上で行えるようになり、プログラムをwarファイルに固めてTomcatのwebappsディレクトリにコピーする作業も省けます。



プロジェクトをMaven依存させて依存関係管理を使用可能に

  1. Eclipseのプロジェクトエクスプローラ上で作成したプロジェクトのルートを右クリック
  2. Maven」メニュー > 「依存関係管理を使用可能にする」メニューを選択
  3. POMの設定を入力して(とりあえずディフォルトのままでも動きます)、「完了」ボタンをクリック

プロジェクトのアイコンが、Mavenが使用できることを示す「M」付きになります。
おそらくこの時点でコンパイルエラーになっています。

コンパイルエラーの解消

  1. プロジェクトのプロパティを開く > 「Javaコンパイラ」メニューで、バージョンをディフォルトコンパイラ(JDK1.6準拠)に変更します
  2. エラーは解除されますが、まだ警告が残っているので「問題」タグに表示されているエラーを右クリックして「クイック・フィックス」メニューを選択します。


サーバーを起動して動作確認

  1. 「/mockapp/src/main/webapp/test.txt」新規テキストファイルを作成
  2. text.txtに適当に文字を入力
  3. Eclipseのプロジェクトエクスプローラ上で作成したプロジェクトのルートを右クリック
  4. 「実行」メニュー > 「サーバで実行」メニュー を選択
  5. 「ローカル・ホストのTomcat5.5サーバ」を選択
  6. 「完了」ボタンをクリック
  7. サーバが起動するのを待つ
  8. Webブラウザで「http://localhost:8080/mockapp/test.txt」にアクセス
  9. 入力した文字が表示されたことを確認