JAX-RS Web サービスは、JAX-RS ファセットに対応したプロジェクトに置かれている必要があります。
- Java EE パースペクティブで、エンタープライズ・アプリケーション・プロジェクトを右クリックし、を選択し、「Web プロジェクト」ウィザードを開きます。
- 「名前」フィールドに、新し
い Web プロジェクトの名前を入力します。このチュートリアルでは、JAXRS を使用します。
- 「プロジェクト・テンプレート」セクションで、使用する Web テンプレートのタイプを選択します。このチュートリアルでは、「シンプル」を選択します。
オプション |
説明 |
Dojo Toolkit |
Dojo 機能を備えるようにプロジェクトを構成します。Dojo リソースを置く場所は、そのプロジェクト自体、別のプロジェクト、または HTTP を介してアクセス可能なリモート・ロケーションのいずれであってもかまいません。 |
JavaServer Faces |
プロジェクトを JSF 機能と共にデプロイできるようにします。
JSP 用の構成または Facelet 用の構成が提供されます。 |
REST サービス |
JAX-RS に基づき REST サービス用に構成されたプロジェクト |
シンプル |
これにより、基本 Web プロジェクトが作成されます。 |
- 「プログラミング・モデル」セクションで、使用するプログラミング・モデルを選択します。このチュートリアルでは、「Java EE」を選択します。
- クライアント・サイドのみ (HTML、JavaScript、...)
- Java EE
- OSGi
- 「次へ」をクリックして、新規 Web プロジェクトを構成します。
- 「デプロイメント」ページの選択可能構成オプションのリストから「デプロイメント」をクリックして、「デプロイメント構成」ページを開きます。
- 「ターゲット・ランタイム」フィールドで、チュートリアルで事前にインストールした WebSphere Application Server を選択します。
- 「Web モジュールのバージョン」フィールドで、
どの WebSphere Application Server を選択したのかに基づいて自動的に
選択されるデフォルトを受け入れます。
- 「EAR メンバーシップ」フィールドで、「EAR にプロジェクトを追加」を選択し、JAXRSEAR が EAR プロジェクト名であることを確認します。
- 「デプロイメント」セクションの下にある「フィーチャーの変更」選択します。
「プロジェクト・ファセット」ページで、「JAX-RS (REST Web Services)」を選択し、バージョンとして「1.1」を選択し、「OK」をクリックします。
- 選択可能構成オプションのリストから「Java」をクリックして、「Java 構成」ページを開きます。
- 「ビルド・パス上のソース・フォルダー」フィールドでデフォルトの src ディレクトリーを受け入れるか、「フォルダーの追加」、「編集...」または「削除」をクリックして、ソース・ファイルのフォルダーを指定します。
- 「デフォルト出力フォルダー:」フィールドで出力ファイルのフォルダーを指定するか、デフォルト値 (WebContent¥WEB-INF¥classes) を受け入れます。
重要: デフォルトの出力フォルダー
として WebContent¥WEB-INF¥classes 以外のフォルダーを選択した場合、
問題ビューに次のような警告が表示されます。
単一ルートの問題があった場合のデフォルトのアクションは、警告に設定されています。
この設定を変更するには、
次のように
「プロジェクト構造バリデーターの検査フィルター」ページを使用します。
- をクリックし、次に、「設定」に対して「...」ボタンをクリックします。
- 「プロジェクト構造バリデーターの検査フィルター」ページで、
デフォルトの重大度レベルを指定します。選択可能な重大度レベルは、「エラー」、「警告」、
および「無視」です。
- 選択可能構成オプションのリストから「REST Services」をクリックして、「REST Services 構成」ページを開きます。
「JAX-RS 実装ライブラリー」フィールドで、
「IBM WebSphere Application Server v<x> JAX-RS ライブラリー」を選択します。
次の値が表示されることを確認します。
- 「JAX-RS サーブレット名:」フィールドに「JAX-RS サーブレット」が表示されることを確認します。
- 「JAX-RS サーブレット・クラス名:」フィールドに com.ibm.websphere.jaxrs.server.IBMRestServlet が表示されることを確認します。
- 「URL マッピング・パターン:」フィールドに /jaxrs/* が表示されることを確認します。
ライブラリーについてさらに学習したい方に: インストールした各 WebSphere Application Server の JAX-RS ライブラリー
がこのドロップダウン・ボックスにリストされます。WebSphere ライブラリー以外を使用したい場合、「ユーザー・ライブラリー」の設定ページを使用してインポートできます。「ユーザー・ライブラリー」を選択すると、「ユーザー・ライブラリー」設定ページを起動してライブラリーを追加できます。プロジェクト
が作成された後、ページでライブラリーを変更できます。
- 選択可能構成オプションのリストから、「Web モジュール」をクリックします。「Web モジュール構成」ページで、以下のようにします。
- 「コンテキスト・ルート」フィールドに、Web プロジェクト・ルートの名前を入力するか、デフォルト (Web プロジェクトの名前) を受け入れます。
- 「コンテキスト・ディレクトリー」フィールドにコンテンツ・ディレクトリーの名前を入力するか、デフォルト (WebContent) を受け入れます。
- デプロイメント記述子を作成する場合は、「web.xml デプロイメント記述子の生成」を選択します。
デプロイメント記述子を後で Web モジュールに追加することもできます。web.xml を使用して、セキュリティー制約および他の動作を構成する必要があります。
- 「終了」をクリックします。
ファセットによって、ライブラリー、サーブレット情報、JAX-RS 注釈処理サポート、および JAX-RS クイック・フィックスが追加されます。
これで、次のモジュールの『Web サービスの作成とテスト』 を開始する準備が完了しました。