Oracle Application Server Web Services開発者ガイド 10g(10.1.3.1.0) B31868-01 |
|
この章では、JAX-RPCまたはRESTのWebサービスのデプロイをテストする方法について説明します。Webサービスの操作を起動できれば、Webサービスは正常にデプロイされています。テストを行うため、Oracle Application Server Web Servicesではテスト・ページが提供されています。Webサービス・テスト・ページを使用すると、次のタスクを実行できます。
次の各項では、Webサービス・テスト・ページにアクセスして使用する方法を詳しく説明します。
次の手順では、JAX-RPCまたはRESTのWebサービスのテスト・ページの機能にアクセスして使用する方法について説明します。後の項では各ステップについてさらに詳しく説明します。
テスト・ページには、Application Server ControlまたはWebブラウザからアクセスできます。このステップの詳細は、「Webサービス・テスト・ページへのアクセス方法」を参照してください。
このステップの詳細は、「テスト・ページでの値の編集」を参照してください。
このステップの詳細は、「WS-Securityおよび信頼性メッセージ機能のテスト」を参照してください。
このステップの詳細は、「Webサービス・テストに対するHTTP認証の有効化」を参照してください。
このステップの詳細は、「Webサービス操作のストレス・テスト」を参照してください。
JAX-RPCまたはRESTのWebサービスに対するリクエストは、SOAPリクエストとして起動できます。REST Webサービスの場合は、SOAPリクエスト、HTTP POST操作またはHTTP GET操作として起動できます。このステップの詳細は、「Webサービスのテストの起動」を参照してください。
JAX-RPCまたはRESTのWebサービスに対するURIをWebブラウザに直接入力して、またはApplication Server Controlを使用して、テスト・ページにアクセスできます。
JAX-RPCまたはRESTのWebサービスに対するテスト・ページに直接アクセスするには、サービス・エンドポイントのアドレスをWebブラウザに入力します。このアドレスの書式は、次のとおりです。
http://host:port/context-root/service
表13-1で、アドレスのコンポーネントについて説明します。
Application Server Controlを使用して、特定のJAX-RPCまたはREST Webサービスに対するテスト・ページにアクセスできます。次の手順は、テスト・ページに移動するためのツールの使用方法の概要です。詳細は、Application Server Controlのオンライン・ヘルプのWebサービス・ページに関するトピックを参照してください。
Enterprise Managerで「Webサービスのテスト」ページが表示され、現在の環境で定義されているWebサイトがリストされます。
Enterprise Managerは、選択されたアプリケーションとWebサイトに対して定義されているコンテキスト・ルートに関する情報に基づいて、URLを生成します。「URL」フィールドにURLが表示されます。
Webサービス・テスト・ページがSSL(Secure Sockets Layer)で保護されている場合は、使用するためには追加の構成手順を実行する必要があります。手順は、OracleAS Web ServicesがOracle HTTP Serverで実行しているかどうかによって異なります。
opmn.xml
ファイルに追加するのみで済みます。これは、Oracle Process Manager and Notification Server(OPMN)に対する主な構成ファイルです。
opmn.xml
ファイルの編集に加えて、Oracleウォレットでユーザー証明書をエクスポートし、それを信頼できる証明書としてOC4Jキーストアにインポートする必要があります。 次の各項では、SSLで保護されたテスト・ページにアクセスするために必要な変更を行う方法について説明します。
OracleAS Web Servicesをスタンドアロン・アプリケーションとして実行している場合は、SSLで保護されたWebサービス・テスト・ページにアクセスするには次の手順に従います。
opmn.xml
ファイルを検索します。opmn.xml
ファイルは次の場所にあります。
ORACLE_HOME
/opmn/conf/opmn.xml
ORACLE_HOME
は、OracleAS Web Servicesをインストールしたディレクトリです。
ファイルはすでにSSL用に構成されているものとします。
opmn.xml
のOC4J start-parameters
セクションに次のプロパティを追加し、ファイルを保存します。これらのプロパティの詳細は、表13-2を参照してください。これらのプロパティを使用しているopmn.xml
ファイルのサンプルは、例13-1を参照してください。
たとえば、次のコマンドは、すべてのOPMNプロセスを停止してから再起動します。
prompt
> opmnctl startall
予想されるSOAPメッセージのレスポンスを受け取ります。
表13-2は、キーストアとトラストストアについてOracle HTTPSがサポートするプロパティです。
例13-1は、キーストアおよびトラストストア・プロパティを含むopmn.xmlファイルのフラグメントを示しています。この例で、<ias-component id="default-group">
はOC4J開始パラメータ・セクションの開始位置を示しています。
<opmn> ... <ias-component id="default-group"> <process-type id="home" module-id="OC4J" status="enabled"> <module-data> <category-id="start-parameters"> <data-id="java-options" value="..-Djavax.net.ssl.trustStore=<
full path to OC4J keystore file>
,-Djavax.net.ssl.trustStorePassword=<
OC4J keystore password>
, -Djavax.net.ssl.keyStore=<full path to OC4J keystore file>, -Djavax.net.ssl.keyStorePassword=<OC4J keystore password>, ...> </category> ... </module-data> </process-type> </ias-component> ... </opmn>
OracleAS Web ServicesをOracle HTTP Server上で実行している場合は、SSLで保護されたWebサービス・テスト・ページにアクセスするには次の手順に従います。
opmn.xml
ファイルを検索します。opmn.xml
ファイルは次の場所にあります。
ORACLE_HOME
/opmn/conf/opmn.xml
ORACLE_HOME
は、OracleAS Web Servicesをインストールしたディレクトリです。
ファイルはすでにSSL用に構成されているものとします。
opmn.xml
のOC4J start-parameters
セクションに次のプロパティを追加し、ファイルを保存します。これらのプロパティについては、前の項の表13-2を参照してください。これらのプロパティを使用しているopmn.xml
ファイルのサンプルは、例13-1を参照してください。
Oracle Wallet Managerは次の場所にあります。
ORACLE_HOME
/bin/owm
次はウォレット・ファイルのパスの例です。
ORACLE_HOME
/Apache/Apache/conf/ssl.wlt/default/ewallet.p12
証明書のエクスポート方法は、Oracle Wallet Managerのマニュアルを参照してください。
たとえば、次のコマンドは、すべてのOPMNプロセスを停止してから再起動します。
prompt
> opmnctl startall
予想されるSOAPメッセージのレスポンスを受け取ります。
Oracle Application Server Web Servicesでは、デプロイされたWebサービスごとにテスト・ページが提供されます。テスト・ページを使用すると、JAX-RPC WebサービスまたはRESTサービスで公開されている操作を実行できます。
図13-1は、HelloServiceEJB
JAX-RPC WebサービスのsayHello
操作に対するWebサービス・テスト・ページです。
JAX-RPCまたはREST WebサービスのWSDLを表示するには、「Service Description」リンクをクリックします。Webブラウザの「ファイル」→「名前を付けて保存」操作を使用して、WSDLをローカルに保存できます。
テスト・ページに戻るには、「戻る」ボタンをクリックします。
図13-2は、JAX-RPC WebサービスのWSDLのフラグメントです。
図13-3は、REST WebサービスのWSDLのフラグメントです。
テスト・ページでは、JAX-RPCまたはREST Webサービスで公開されている操作をテストできます。デフォルトでは、操作の編集可能なパラメータと属性がHTML形式で表示されます。フォーム上のオプションのパラメータと属性は、チェック・ボックスで示されます。パラメータに値を設定するには、チェック・ボックスを選択します。
テストするWebサービス操作を選択するには、「操作」ドロップダウン・リストを使用します。
フォームの「+
」リンクは、構造のコピーを追加できることを示します。
フォームの「X
」リンクは、不要な構造のコピーを削除できることを示します。
JAX-RPCまたはREST Webサービス操作に対する値をHTMLフォームで入力するかわりに、XMLソース・コードに直接入力できます。そのためには、テスト・ページで「XMLソース」ラジオ・ボタンを選択します。
セキュリティおよび信頼性に対する値を変えて、JAX-RPC Webサービス操作を起動できます。これらのパラメータを公開するには、「信頼できるメッセージング」および「WSセキュリティ」の隣のノードを展開します。
図13-4は、HTMLフォームでのセキュリティおよび信頼性に対するパラメータとデフォルト値を示しています。
信頼性機能をテストに含めることを示すには、「信頼できるメッセージング」ノードを展開します。信頼性SOAPヘッダーがリクエストのSOAPエンベロープに挿入されます。
次のパラメータの設定を変更できます。
セキュリティ機能をテストに含めることを示すには、「WSセキュリティ」チェック・ボックスを選択します。セキュリティSOAPヘッダーがSOAPエンベロープに挿入されます。
次のパラメータの設定を変更できます。
「トランスポート情報の表示」ノードを展開すると、JAX-RPCまたはREST Webサービスに対するHTTP認証オプションが表示されます。テストしているHTTPサービスがパスワードで保護されている場合は、「トランスポート情報の表示」の下のパラメータを使用すると、ユーザー名とパスワードを提供できるようになります。SOAPリクエストに対する特殊なフィルタを提供する必要のあるサービスの場合は、「SOAPアクション」に値を指定できます。
図13-5は、テスト・ページの「トランスポート情報の表示」パラメータです。
「ストレス・テストの実行」ノードを展開すると、JAX-RPCまたはREST Webサービス操作の連続的な一連の起動を作成および構成するためのオプションが表示されます。「ストレス・テストの実行」のオプションは図13-5に示されています。
テストを起動すると、ストレス・レポート・ページが返されます。レポート・ページでは、テストされたサービス・エンドポイントと操作、送信されたメッセージのサイズ、実行された同時スレッドの数、スレッドごとの実行回数および各操作起動の間の遅延が示されます。図13-6は、サンプルのストレス・テスト・レポートのフラグメントです。
操作でテストするパラメータ値と機能を指定したなら、Webサービス・エンドポイントにメッセージを送信できます。JAX-RPC Webサービスの場合は、メッセージはSOAPリクエストとしてサービスに送信されます。REST Webサービスの場合は、SOAPリクエスト、XML REST GET操作またはPOST操作のいずれかとしてメッセージを送信できます。
SOAPリクエストとしてJAX-RPC Webサービス・エンドポイントにメッセージを送信するには、「起動」ボタンをクリックします。テスト・ページにサービスからのレスポンスが表示されます。レスポンスは、書式設定されたXML(デフォルト)またはRAW XML(ワイヤ書式)で表示できます。
REST Webサービス用のテスト・ページでは、XML REST POST操作またはGET操作としてRESTサービスにテスト・メッセージを送信できます。さらに、OracleAS Web Servicesでは、SOAPリクエストとしてメッセージを送信することもできます。
テスト・ページにある次のボタンを使用して、テスト・メッセージに対するWebサービス操作を起動できます。
図13-8は、RESTに対応したWebサービス操作用のテスト・ページです。
HTTP経由でSOAPメッセージとしてサービスにXML RESTリクエストを送信するには、「起動」ボタンをクリックします。サービスは、SOAPレスポンス・メッセージをテスト・ページ・アプリケーションに戻します。レスポンスは、書式設定されたXML(デフォルト)またはRAW XML(ワイヤ書式)で表示できます。
図13-9は、書式設定されたXMLで表示されたREST WebサービスからのSOAPレスポンスです。
REST Webサービスにメッセージを送信するには、テスト・ページの「REST POSTの起動」をクリックします。レスポンスがテスト・ページ・アプリケーションに戻されます。レスポンスは、書式設定されたXML(デフォルト)またはRAW XML(ワイヤ書式)で表示できます。
図13-10は、REST POST操作からのREST Webサービス・レスポンスです。
WebブラウザでのHTML GETコマンドとしてサービスにリクエストを送信するには、テスト・ページの「REST GETの起動」をクリックします。レスポンスは、テスト・ページ・アプリケーションではなくブラウザに表示されます。
図13-11は、REST GET操作からのREST Webサービス・レスポンスです。
テスト・ページを無効にすることで、Webサービスを公開するアプリケーションの詳細が外部から見られにくくなり、セキュリティが向上します。
テスト・ページを無効にするための一般的な手順は、次のとおりです。
oracle-webservices.xml
デプロイメント・ディスクリプタを抽出します。
<webservice-description>
セクションに、false
に設定したブール型要素<expose-testpage>
を挿入します。 例13-2は、この手順を示したものです。
oracle-webservices.xml
デプロイメント・ディスクリプタで、JARファイルを置き換えます。
例13-2は、テスト・ページを無効にしたoracle-webservices.xml
デプロイメント・ディスクリプタのフラグメントです。
<oracle-webservices> ... <webservice-description name="with-test-page-blocked"> <expose-testpage>false</expose-testpage> ... </webservice-description> </oracle-webservices>
Webサービス・テスト・ページを使用しないでWebサービスのWSDLファイルを取得する場合は、直接取得できます。
WSDLを取得するには、WebサービスのURLを使用して問合せ文字列を追加します。WSDLサービス記述を取得するためのURLの書式は、次のとおりです。
http://host:port/context-root/service?WSDL
WSDL
は大文字でも小文字でもかまいません。URLコンポーネントの詳細は、表13-1を参照してください。
このURLでは、WSDL記述がservice.wsdl
の形式で戻されます。service.wsdl
の記述には、指定したURLにあるWebサービスserviceのWSDLが含まれています。このWSDLを使用すると、そのWebサービスにアクセスするクライアント・アプリケーションを作成できます。
「Webサービス・デプロイのテスト」を参照してください。
Webサービス・テスト・ページを使用できるWebサービスの詳細は、次の章を参照してください。
Web Services SecurityおよびWeb Services Reliabilityの詳細は、次のマニュアルを参照してください。
|
Copyright © 2006 Oracle Corporation. All Rights Reserved. |
|