Web フラグメント・プロジェクト・ウィザードを使用すると、ワークスペースに Web フラグメント・プロジェクトを作成できます。
始める前に
Web フラグメントとは、Web アプリケーションのロジカル・パーティションで、Web アプリケーションで使用されるフレームワークは、ユーザーが web.xml 内の情報を編集したり追加したりしないでも、すべての成果物を定義できます。Web フラグメントには、web.xml 記述子が使用するのとほとんど同じすべてのエレメントを含めることが可能です。ただし、以下の要件を満たす必要があります。
- 記述子のトップレベル・エレメントを Web フラグメントとする必要があります。
- 対応する記述子ファイルは、web-fragment.xml という名前にしてください。
フレームワークが JAR ファイルとしてパッケージされ、デプロイメント記述子の形式でメタデータ情報が入っている場合には、web-fragment.xml 記述子をその JAR ファイルの META-INF/ ディレクトリーに格納する必要があります。
Web フラグメントは、
インクリメンタル・デプロイメント
情報 (web-fragment.xml 内にある) および関連するクラス (存在する場合) の両方が
含まれるプラグ可能ライブラリー JAR ファイルを使用して、Web アプリケーションのデプロイメント記述子を定義または拡張するためのメカニズム
です。また、Web フラグメントは META-INF ディレクトリーの web-fragment.xml により、ライブラリー (JAR) としてパッケージされます。そのため、Web フラグメント・プロジェクトは基本的にはユーティリティー・プロジェクトの 1 つで、Web フラグメント・ファセットが追加されています。Web フラグメント・ファセットを使用すると、フラグメント・プロジェクトに関連するコンテキスト・センシティブ機能を追加できます。
手順
- Java™ EE パースペクティブで、を選択します。「Web フラグメント」ウィザードが開きます。
- 「プロジェクト名」フィールドに、Web フラグメント・プロジェクトの名前を入力します。デフォルトのプロジェクト・ロケーションを
変更するには、「デフォルト・ロケーションを使用」チェック・ボックスをクリアし、
「参照」ボタンをクリックして新しいロケーションを選択します。
別のプロジェクトで既に使用されている、デフォルト以外のプロジェクト・ロケーションを指定すると、プロジェクトの作成は失敗します。
- 「ターゲット・ランタイム」フィールドには、
エンタープライズ・プロジェクトからの選択によって既にデータが取り込まれています。
- オプション: 「構成」ドロップダウン・リストで、定義済みのプロジェクト構成を選択します。
- オプション: 構成の詳細を変更する場合は、「変更」をクリックします。
- 「プロジェクト・ファセット」リストで、1 つ以上のプロジェクト・ファセットを選択します。
サーバー・ランタイム環境を指定するには、
「ランタイム」をクリックし、1 つ以上のランタイムを選択します。
選択したら、「OK」をクリックしてカスタム構成を保存してください。
- オプション: 新規モジュールを Web アーカイブ (WAR) プロジェクトに追加するには、「動的 Web プロジェクトへのプロジェクトの追加 (Add project to Dynamic Web project)」チェック・ボックス
を選択します。 新しい動的 Web プロジェクトの名前を入力するか、
「動的 Web プロジェクト名」組み合わせボックスのドロップダウン・リストから
既存のプロジェクトを選択します。あるいは、「新規」をクリックして、「動的 Web プロジェクト」ウィザードを
起動します。
- 「ワーキング・セットにプロジェクトを追加」を
選択して Web フラグメント・プロジェクトを既存のワーキング・セットに追加するか、または、「選択」を
クリックしてワーキング・セットを見つけます。「次へ」をクリックします。
- 「Java アプリケーションをビルドするためにプロジェクトを構成します」ページにある「ビルド・パス上のソース・フォルダー」フィールドで、「フォルダーの追加...」をクリックして、ビルド・パス上にソース用フォルダーを追加するか、デフォルト値 (src) を受け入れます。
- 「デフォルト出力フォルダー」フィールドで、出力ファイル用のフォルダーを指定するか、デフォルト値 (bin) を受け入れて、「終了」をクリックします。
- 「エンタープライズ・エクスプローラー」ビューには、結果として生成された Web フラグメント・プロジェクト・フォルダーが表示されます。