JAX-RS Web サービスの作成
始める前に
- WebSphere® Application Server v7.0 または v8.0 で、Feature Pack for Web 2.0 AND MOBILE および WebSphere Application Server 開発用ツールのインストールを選択する。
WebSphere Application Server 以外のサーバーへの デプロイを選択する場合は IBM® JAX-RS ライブラリーを使用することはできず、 「プロジェクト・ファセット」>「JAX-RS」設定ページから、独自の JAX-RS ライブラリーを インストールして構成する必要があります。
WebSphere Application Server での JAX-RS Web サービスの使用について詳しくは、WebSphere Application Server のインフォメーション・センターを参照してください。
JAX-RS 対応の Web プロジェクトの作成
このタスクについて
[WebSphere Application Server traditional] WebSphere Application Server traditional V9 は、JAX-RS 1.1 と 2.0 をサポートします。プロジェクトで使用する JAX-RS のバージョンは、WebSphere Application Server traditional V9 のインストール済み環境で使用する JAX-RS のバージョンと一致していなければなりません。これらのバージョンが一致していない場合、プロジェクトをサーバーにデプロイするときに、ツールにより警告が表示されます。ファセット・レベルを指定せずに JAX-RS プロジェクトを作成すると、ツールはデフォルトで JAX-RS 2.0 を使用します。
com.ibm.ws.jaxrs.jar
com.ibm.ws.prereq.jaxrs.jar
javax.j2ee.jaxrs.jar
com.ibm.ws.jaxrs20.jar
com.ibm.ws.prereq.jaxrs20.jar
javax.ws.rs-api-2.0.jar
手順
JAX-RS Web サービスの作成
手順
- Web プロジェクトで、パッケージを作成します (右クリックからを選択し、を選択します)。Web サービスのクラスを パッケージにインポートします。
- WebContent/WEB-INF/web.xml を開きます。「設計」ビューで Servlet JAX-RS Servlet を選択し、名前および値フィールドが空白の状態で「追加」をクリックし、初期化パラメーターを JAX-RS サーブレットに追加します。web.xml を保存します。その際にエラーが表示される場合がありますが、無視してください。
- 「マーカー」ビューで、param-name に関する web.xml エラーを選択し、 右クリックして「クイック・フィックス」を選択します。アプリケーションをブラウズして、 選択します。
- JAX-RS プロジェクトが含まれる EAR をサーバーに追加し、 サーバーを始動します。
タスクの結果
すべての Web アプリケーションには、Web アプリケーションが 正常にデプロイするように、コンテキスト・ルートがなければなりません。各 Web モジュールの コンテキスト・ルートは、アプリケーション・アセンブリーまたはアプリケーション・デプロイメントの実行中に アプリケーション・デプロイメント記述子で定義されます。コンテキスト・ルートは、 WAR ファイルからの定義済みのサーブレット・マッピングと結合され、 ユーザーがサーブレットにアクセスする際に入力する完全な URL が作成されます。デプロイ済みの各 Web アプリケーションの コンテキスト・ルートは、サーバー上で固有でなければなりません。 コンテキスト・ルートは空にしておくこともできます。
例えば、 Web アプリケーションで sample/application/ というコンテキスト・ルートを使用する場合、この Web アプリケーションの要求 URL は http://<hostname>:<port>/sample/application/ で始まります。サーブレットの URL パターンは、Web アプリケーションの コンテキスト・ルートに追加されます。例えば、コンテキスト・ルートが sample/application/ でサーブレット URL マッピングが rest/api/* である場合、JAX-RS Web アプリケーションのベース URI は http://<hostname>:<port>/sample/application/rest/api となります。
JAX-RS プロジェクトの編集
- ライブラリー・タイプ
- JAX-RS サーブレット名
- JAX-RS サーブレット・クラス名
- URL マッピング・パターン