汎用サービス・クライアントを使用すると、
他のテスト用メカニズム (JMS Web サービスやセキュア Web サービスなど) に比べてより多様な Web サービスをテストできます。
汎用サービス・クライアントは、HTTP、JMS、または WebSphere® MQ トランスポートを使用するあらゆる種類のサービスの呼び出しを起動し、サービスから
戻されるメッセージを表示します。汎用サービス・クライアントは、サービスの呼び出しの起動を行う専用クライアントへのアクセス権限がない場合に、サービスのデバッグやテストを行う際に便利です。
サービスのさまざまなトランスポートおよびセキュリティー構成をセットアップしたり、
呼び出しのパラメーターを編集したり、添付を送信したりすることができます。
汎用サービス・クライアントを使用して Web サービスをテストする方法について詳しくは、
汎用サービスを使用したサービス要求の送信を参照してください。
サポート対象サービス
汎用サービス・クライアントは、
以下のトランスポート・プロトコルを使用するさまざまなタイプのサービスへの要求を起動することができます。
- HTTP
- JBoss および WebSphere® 実装を含む、Java™ Message Service (JMS)
- WebSphere MQ
汎用サービス・クライアントは、現時点ではセキュア Web サービスの
テストをサポートしていません。
Web サービスをテストするために汎用サービス・クライアントを使用する、次のデモンストレーションをご覧ください: 汎用サービス・クライアントを使用した Web サービスのテスト
汎用サービス・クライアントの起動
汎用サービス・クライアントは、次の方法で起動できます。
- 「エンタープライズ・エクスプローラー」ビューの WSDL ファイルを右クリックし、を選択する
- 「サービス」ビューでサービス・ノードを右クリックし、「汎用サービス・クライアントのテスト」を選択する
- 「実行」メニューから、「汎用サービス・クライアントの起動」を選択する
- 「Web サービス」ウィザードで、汎用サービス・クライアントをテスト機能として選択する。Web サービス設定のデフォルトのテスト機能に設定することもできます。
- ツールバーの「汎用サービス・クライアントの起動」アイコン をクリックします。
WSDL ファイルからの汎用サービス・クライアントの起動
開始する前に、有効な Web サービス記述言語 (WSDL) ファイル
がワークスペース内にあることを確認してください (JAX-WS Web サービスで
は WSDL ファイルの動的生成がサポートされていることとは対照的です)。 WSDL ファイルがテスト環境に対して正しい構文を使用していることを確認してください。
汎用サービス・クライアントは、一部の WSDL ファイルでは使用できない可能性があります。
WSDL ファイルに基づいてサービス呼び出しを起動するには、以下のステップを完了します。
- 汎用サービス・クライアントを起動し、必要な場合は WSDL ファイルを追加します。WSDL ファイルは呼び出しライブラリーに追加されます。
- 呼び出しライブラリーで WSDL、バインディング、および操作を展開し、
呼び出し要素を選択します。呼び出しは、WSDL で使用可能な SOAP または JMS エンドポイントで自動的に構成されます。
汎用サービス・クライアントには 3 つのステップが表示されます。
「データの編集」、「起動」、および「応答の表示」です。呼び出しの詳細は「データの編集」ステップの下に表示されます。
- 「メッセージ」ページで、「フォーム」、「ツリー」、または「ソース」ビューを使用して、呼び出しの内容を編集します。
各ビューは、同じデータを異なる方法で表示します。「フォーム」または「ツリー」ビューに XML 要素を追加したり削除したりするには、
をクリックして、スキーマ・カタログで指定された XML スキーマ定義 (XSD) に準拠するようにします。
- 「添付」ページで、呼び出しと一緒に送信される任意の添付ファイルを指定します。添付ファイルを扱うには、最初に環境を正しいライブラリーと構成ファイルで構成する必要があります。
- 「トランスポート」ページで、呼び出しによって使用される HTTP、
JMS、または WebSphere MQ トランスポート構成を指定します。
トランスポートおよびセキュリティー構成は、「トランスポート」タブをクリックすることで作成したり編集したりすることができます。
- 「要求のセキュリティー」および「応答のセキュリティー」ページで、WSDL のセキュリティー設定をオーバーライドするかどうか指定します。
WSDL の現行のセキュリティー設定を編集するには、
「WSDL セキュリティーの編集」をクリックして
「WSDL セキュリティー・エディター」を開きます。
- 準備ができたら、「起動」をクリックして、サービス呼び出しを起動します。
汎用サービス・クライアントは要求を送信し、メッセージの戻りが「応答の表示」ステップの下に表示されます。
制限:
配列はサポートされていません。
仕様の欠如により、
添付は Java Message Service (JMS) トランスポートではサポートされていません。
エンベロープは UTF-8 エンコードを使用して直接送信されます。
各 Java Runtime Environment (JRE) 実装で、すべてのセキュリティー・アルゴリズムが常に使用可能であるとは限りません。
特定のセキュリティー実装が使用不可である場合、この製品が使用する JRE のクラスパスに、必須ライブラリーを追加します。
汎用サービス・テスターはエンベロープを、XML 文書に反映されているように表示します。
ただし、セキュリティー・アルゴリズムはエンベロープをバイナリーとして扱います。
そのため、着信および発信メッセージは正しく暗号化されているがテストの内側では暗号化解除されているように、SOAP セキュリティー構成をセットアップする必要があります。