ヘッダーをスキップ
Oracle Web Services Manager管理者ガイド
10g(10.1.3.3.0)
E05572-01
  目次
目次
索引
索引

戻る
戻る
次へ
次へ
 

B Oracle Web Services Managerのテスト・ページ

この付録では次の項について説明します。

Oracle Web Services Manager(Oracle WSM)には、Oracle WSMをデプロイする環境でWebサービス操作の検証に使用するテスト・ページが用意されています。Oracle WSMのテスト・ページは、テストに必要とされる、有効なWebサービス・リクエストを自動的に生成します。Oracle WSMは、Oracle WSM GatewayまたはOracle WSM AgentにリモートWebサービスを登録する前に、そのサービスが機能するかどうかを検証する目的でサービスをテストする方法をユーザーに提供します。

「Webサービスのテスト」ページでは、JAX-RPCまたはREST Webサービスのデプロイが成功したかどうかをテストします。このページを使用すると、次のタスクを実行できます。

WebサービスWSDLの表示

WSDLをテストして、Webサービスにアクセスできるかどうかを確認するには、WSDLが登録されているOracle WSM Gatewayにリクエストを行う必要があります。そのためには、リクエストの送信先URLを取得する必要があります。

WebサービスのWSDLを表示するには

  1. Web Services Manager Controlのナビゲーション・ペインから、「ポリシー管理」「サービスの登録」を選択します。

  2. サービスが登録されているゲートウェイの「サービス」をクリックします。

  3. 「サービスのリスト」で、サービスの「編集」をクリックします(図B-1)。

    図B-1 「サービスのリスト」ページ

    図B-1の説明が続きます。
    「図B-1 「サービスのリスト」ページ」の説明

  4. 「サービスの編集」ページの「サービスのWSDL URL」フィールドでURLをコピーします(図B-2)。

    図B-2 サービスのWSDL URLのコピー

    図B-2の説明が続きます。
    「図B-2 サービスのWSDL URLのコピー」の説明

Webサービスのテスト

この項では、「Webサービスのテスト」ページを使用して、Webサービスから想定どおりの結果を受信できるかどうかを確認する方法について説明します。

Webサービスをテストするには

  1. Web Services Manager Controlのナビゲーション・ペインから、「ツール」「テスト・ページ」を選択すると、「Webサービスのテスト」ページが表示されます(図B-3)。

    図B-3 「Webサービスのテスト」ページ

    図B-3の説明が続きます。
    「図B-3 「Webサービスのテスト」ページ」の説明

  2. ボックスにWSDL URLを入力して、「問合せの発行」をクリックします。

    ページが更新され(図B-4)、WSDLのエンドポイントURLとポートが表示されます。「ポート」を使用して、Webサービスへのアクセスに使用するプロトコルとネットワーク・アドレスを指定します。次の項で説明するように、テストを構成して様々なタスクを実行できます。

図B-4 追加パラメータが表示された「Webサービスのテスト」ページ

図B-4の説明が続きます。
「図B-4 追加パラメータが表示された「Webサービスのテスト」ページ」の説明

「Webサービスのテスト」ページの値の編集

「Webサービスのテスト」ページを使用すると、JAX-RPCまたはREST Webサービスで公開されている任意の操作をテストできます。デフォルトでは、編集可能なパラメータと属性はHTMLフォームで表示されます。フォーム上のオプションのパラメータと属性は、チェック・ボックスで示されます。

パラメータの値を入力するには、チェック・ボックスを選択します。


注意:

HTMLフォーム上で属性とパラメータを区別するために、属性の前には@記号が付いています。

「操作」リストを使用して、テストするWebサービス操作を選択します。

フォーム上のプラス記号(+)は、構造のコピーを追加できることを示します。

フォーム上のXは、使用しない構造のコピーを削除できることを示します。

XMLソースとしての「Webサービスのテスト」ページの編集

HTMLフォームでJAX-RPCまたはREST Webサービス操作の値を入力するかわりに、XMLソース・コードに値を直接入力できます。これを行うには、「Webサービスのテスト」ページの「XMLソース」オプションを選択します。


注意:

XMLソースに値を入力する場合、属性の前に@記号を付ける必要はありません。

XMLソースに操作の値を入力して、HTMLフォーム・モードに切り替えても、入力した値は保存されません。フォームは値がクリアな状態で表示されます。

「Webサービスのテスト」ページの使用方法

「Webサービスのテスト」ページを使用する場合、次の事項を念頭に置いてください。

  • パラメータを公開するには、該当の機能の横にあるプラス記号(+)をクリックします。特定のパラメータについては後続の項で詳しく説明します。

  • 特定の機能を選択してその機能をテストすることを明示的に示す必要があります。機能名の横にある「ヘッダーに含める」チェック・ボックス、または「有効化」チェック・ボックスを選択します。チェック・ボックスを選択しない場合、パラメータの値を入力しても、その機能はテストに含まれません。

WS-Securityとメッセージング機能のテスト

セキュリティと信頼性の機能について、様々な値でJAX-RPC Webサービス操作を起動できます。これらの機能のパラメータを公開するには、「信頼できるメッセージング」および「WSセキュリティ」の横にあるチェック・ボックスを選択します。テストでこれらの機能を有効にするには、「ヘッダーに含める」チェック・ボックスを選択します。


注意:

Oracle Application Server Web Servicesで実装されるREST Webサービスは、セキュリティまたは信頼性の機能をサポートしません。REST Webサービス・リクエストに対してセキュリティまたは信頼性のオプションを指定しても、これらのオプションは無視されます。

信頼できるメッセージングのパラメータ

信頼性の機能をテストに含めることを示すには、「信頼できるメッセージング」チェック・ボックスを選択します。信頼性のSOAPヘッダーが、リクエストのSOAPエンベロープに挿入されます。図B-5に、設定可能なパラメータを示します。

  • 重複削除: この機能を有効にすると、重複削除の信頼性ヘッダーがメッセージに挿入されます。信頼できるエンドポイントに、送信メッセージの重複を削除するよう通知します。デフォルト値は「on」です。

  • 保証付き配信: この機能を有効にすると、保証付き配信の信頼性ヘッダーがメッセージに挿入されます。信頼できるエンドポイントに、メッセージの受信を確認する必要があることを通知します。デフォルト値は「on」です。

  • URLへの返信: 非同期確認を必要とするメッセージについて、確認とフォルトの送信先URLを示します。URLは、通常、リスナーが機能しているポートを持つクライアントのホスト名です。

  • 返信パターン: クライアントがエンドポイントと相互運用する方法を示します。有効な値は、「Callback」(非同期確認またはフォルト)、または「Poll」(確認またはフォルトのポーリングが必要)です。デフォルト値は「Poll」です。

図B-5 「Webサービスのテスト」ページの信頼できるメッセージングのパラメータ

図B-5の説明が続きます。
「図B-5 「Webサービスのテスト」ページの信頼できるメッセージングのパラメータ」の説明

WS-Securityのパラメータ

セキュリティ機能をテストに含めることを示すには、「WSセキュリティ」チェック・ボックスを選択します。セキュリティのSOAPヘッダーが、SOAPエンベロープに挿入されます。「ユーザー名」と「パスワード」パラメータに対して様々な設定を選択できます(図B-6)。

図B-6 「Webサービスのテスト」ページのWS-Securityのパラメータ

図B-6の説明が続きます。
「図B-6 「Webサービスのテスト」ページのWS-Securityのパラメータ」の説明

Oracle WSM Agentの起動

Oracle WSM Agentのパラメータ(図B-7)を使用して、Oracle WSM Agentを経由するWebサービス・リクエストを実行します。エージェントは、Webサービス・リクエストに対して、そのエージェントに構成されたポリシーを適用します。「構成場所」は、Oracle WSM Agentをインストールするディレクトリの場所です。このディレクトリの場所には、完全修飾パスを使用します。

図B-7 「Webサービスのテスト」ページのOracle WSM Agentのパラメータ

図B-7の説明が続きます。
「図B-7 「Webサービスのテスト」ページのOracle WSM Agentのパラメータ」の説明

Webサービスのテストに対するHTTP認証の有効化

JAX-RPCまたはREST Webサービスの「HTTP認証」オプションを表示するには、「トランスポート情報の表示」チェック・ボックスを選択します(図B-8)。テストしているHTTPサービスがパスワードで保護されている場合、「トランスポート情報の表示」の下にあるパラメータを使用して、ユーザー名とパスワードを入力できます。サービスが、SOAPリクエストに対して特殊なフィルタリングを行う必要がある場合、「SOAPアクション」の値も指定できます。

図B-8 「Webサービスのテスト」ページのHTTP認証のパラメータ

図B-8の説明が続きます。
「図B-8 「Webサービスのテスト」ページのHTTP認証のパラメータ」の説明

Webサービス操作のストレス・テスト

JAX-RPCまたはREST Webサービス操作の連続起動を作成および構成するオプションを表示するには、「ストレス・テストの実行」チェック・ボックスを選択します(図B-9)。

図B-9 「Webサービスのテスト」ページのストレス・テストのパラメータ

図B-9の説明が続きます。
「図B-9 「Webサービスのテスト」ページのストレス・テストのパラメータ」の説明

テストを起動すると、ストレス・レポート・ページが返されます。レポート・ページは、テストするサービス・エンドポイントと操作、送信メッセージのサイズ、操作を実行する同時スレッド数、各スレッドで操作を実行する回数、ある操作から次の操作を起動するまでの遅延を特定します。

JAX-RPC Webサービスのテストの起動

JAX-RPC Webサービス・エンドポイントに対し、メッセージをSOAPリクエストとして送信するには、「起動」をクリックします。「テスト結果」には、サービスからのレスポンスが表示されます。このレスポンスは、フォーマット済XML(デフォルト)または生XML(ワイヤー形式)で表示できます。

REST Webサービスのテストの起動

REST Webサービスの「Webサービスのテスト」ページを使用すると、RESTサービスに対し、テスト・メッセージをXML REST POSTまたはGET操作として送信できます。さらに、Oracle Application Server Web Servicesには、SOAPリクエストとしてメッセージを送信するオプションがあります。

「Webサービスのテスト」ページには、テスト・メッセージに対してWebサービス操作を起動できる次のオプションが用意されています。

テストの再利用

「Webサービスのテスト」ページを構成して特定のテストを一度実行すると、これらの設定を保存して、後からそのテストを再利用できます。「テストの保存」の横にあるチェック・ボックスを選択して、テストの名前と説明を入力します(図B-10)。

図B-10 「Webサービスのテスト」ページのテストの保存のパラメータ

図B-10の説明が続きます。
「図B-10 「Webサービスのテスト」ページのテストの保存のパラメータ」の説明

このテストを再実行するには、ナビゲーション・ペインで「ツール」「保存済テスト」を選択します。「テストのリスト」にテストが表示されます。「実行」をクリックしてテストを再実行するか、「編集」をクリックしてテストを変更できます。