WebSphere JAX-WS アドレス帳 RSP Web サービス・サンプルのセットアップ手順

前提条件: サンプルを実行する前に、WebSphere® Application Server v7.0 が定義済みであることを確認する必要があります。デフォルト設定では、サーバーは WebSphere Application Server のインストール時に作成されます。このサーバーは「サーバー」ビューで見ることができます。 ただし、新規にサーバーを作成する場合は、以下を行ってください。
  1. 「ファイル」メニューから、 「新規」 > 「その他」 > 「サーバー」 > 「サーバー」 > 「次へ」と選択します。
  2. サーバーのタイプとして「WebSphere v7 Server」を選択し、「次へ」をクリックします。
  3. ワークスペースにランタイム環境が接続されていない場合は、WebSphere Application Server のインストール・ディレクトリーを尋ねるプロンプトが出されます。
  4. 「サーバー設定」ページで、「終了」をクリックします。
  5. 作成したサーバーをワークスペースに表示するには、「ウィンドウ」メニューから、 「ビューの表示」 > 「その他」 > 「サーバー」 > 「サーバー」 > 「OK」と選択します。
サンプルを実行するには、以下を行います。 サンプルをインポートしたら、TestClient.jsp を使用してそのサンプルを以下のように実行します。
  1. jwsAddressBookRSPClient/WebContent/sampleAddressBookPortProxy/TestClient.jsp を選択し、右クリックして「実行」 > 「サーバーで実行」を選択します。WebSphere Application Server v7.0 プロファイルが選択されていて、 jwsAddressBookRSPEAR がサーバーに追加されていることを確認します。
  2. saveAddress メソッドを選択し、名前フィールドに情報を入力します。 他のすべてのフィールドはオプションです。「起動」をクリックします。
  3. findAddress メソッドを選択し、saveAddress メソッドの実行中に使用した名前を入力し、「起動」をクリックします。saveAddress メソッドによって保存された情報が、「結果」ペインに表示されます。
Web サービスおよびクライアントに関連付けられたポリシー・セットを表示するには、次の 2 つの方法があります。
  • jwsAddressBookRSPEAR/META-INF 内に、clientPolicyAttachements.xml および policyAttachements.xml の 2 つのファイルが作成されています。これらのファイルをデフォルト・エディターで開くことで、クライアントとサービスそれぞれのサービス品質設定を表示できます。
  • JAX-WS Web サービス・ノードの下の「サービス」ビューに、クライアントとサービスがリストされるはずです。 右クリックして「ポリシー・セット添付を管理 (Manage Policy Set Attachment)」を選択することで、 ポリシー・セットを表示または変更できます。
デフォルト以外のポートを使用してサンプルを実行するには、以下を行います。TCP/IP モニターなどのデフォルト以外のポートを介して Web サービスのトラフィックを送付する場合は、サンプルのデフォルト・エンドポイントをモニターのポート番号と一致するように変更する必要があります。
  1. 以下のようにして、WebSphere 管理コンソールで、 WebSphere Application Server が使用しているデフォルト・ポートを知ることができます。
    1. 「サーバー」ビューでご使用のサーバーを右クリックして「管理コンソールの実行」を選択することによって、 WebSphere Application Server 管理コンソールを起動します。
    2. 左側のペインにある「サーバー」を展開し、 「アプリケーション・サーバー」を選択します。
    3. ご使用のサーバー名をリストから選択します。デフォルトでは、これは server1 です。
    4. 「構成」タブで、 「コミュニケーション」の見出しを見つけて「ポート」を展開します。
    5. 使用されるポートは WC_defaulthost です。
  2. TestClient.jsp を実行します。jwsAddressBookRSPClient/WebContent/sampleAddressBookPortProxy/TestClient.jsp を選択し、右クリックして「実行」 > 「サーバーで実行」を選択します。WebSphere Application Server v7.0 プロファイルが選択されていて、 jwsAddressBookRSPEAR がサーバーに追加されていることを確認します。
  3. JSP の「サービス品質」ペインで、「エンドポイント」フィールドのポート番号を変更し、 「更新」をクリックします。
注: 「JAXB を迂回して XML ペイロードを使用 (Bypass JAXB and use XML payloads)」を選択すると、TestClient.jsp メソッドの JAXB バインディング・ビューが未加工の SOAP メッセージで置換されます。この機能を使用する場合は、必要な SOAP ボディ項目を手動で入力する必要があります。これは、Web サービスに含まれるメソッドを、生成されたクライアントですべて処理することができない場合に便利ですが、アドレス帳のサンプルでは必要ありません。
フィードバック