Web サービスは、複数のポートを持つことができます。定義済みの各 Web サービス・ポートのポート属性を表示し、構成することができます。
始める前に
エンタープライズ・アーカイブ (EAR) ファイルをまだデプロイしていない場合は、
このファイルを準備するか、またはアプリケーション・サーバーにデプロイ済みである必要があります。
このタスクについて
同期タイムアウト、オーバーライドされたエンドポイント URL およびトランスポート属性を含む、Web サービス・クライアント・ポートと関連するバインディング属性を WebServicesClientBindPortInfo コマンド行オプションを使用して構成できます。このコマンド行オプションの標準的な使用シナリオは、クライアントのタイムアウト値をカスタマイズすることです。これにより、Java Message Service (JMS) トランスポートを使用して Web サービスにアクセスするように構成するときに、クライアントの待機時間が長くなります。
手順
- スクリプト・コマンドを起動します。 詳しくは、wsadmin スクリプト・クライアントの開始に関する項目を参照してください。
- Web サービス・クライアントのポート情報を構成します。
新規アクティベーション・スペックを使用または作成する代わりに、既存のリスナー・ポートを使用する場合は、EJB JAR バージョンが 2.1 より古いかどうかを確認します。
アプリケーションのデプロイに -usedefaultbindings オプションを指定すると、
アクティベーション・スペックがシステムによって自動的に作成および使用されます。アクティベーション・スペックが存在する場合は、
リスナー・ポートが無視され、代わりにアクティベーション・スペックが使用されます。
新規アクティベーション・スペックの代わりに定義済みのリスナー・ポートを使用して、2.1 以降のバージョンの
EJB JAR でアプリケーションをデプロイするには、対象のプロファイルの properties ディレクトリーの wsadmin.properties ファイルで、
com.ibm.websphere.management.application.dfltbndng.mdb.preferexisting
システム・プロパティーを true に設定します。
install、installInteractive、edit または editInteractive オプションを使用して、Web サービス・クライアントのポート情報を構成します。次に例を示します。
$AdminApp install app_name {-usedefaultbindings
-deployejb -WebServicesClientBindPortInfo {{module_name EJB_name
Web_service port timeout basic_authentication_id basic_authentication_password
SSL_alias overridden_endpoint overridden_binding_namespace }...}}
上記の例は、1 つの WebServicesClientBindPortInfo コマンドを使用して複数のポートのポート情報を
変更できることを示しています。
- app_name はアプリケーション名です。例えば、MultiEjbJar.ear です。
- module_name はモジュール名です。例えば、ejbclientonly.jar です。
- EJB_name は Web モジュールではない EJB の名前です。例えば、Exchange です。
- Web_service は Web サービスの名前です。例えば、service/StockQuoteService です。
- port はポートの名前です。例えば、StockQuote です。
- timeout は、クライアントが応答を待つ時間を秒数で指定します。
- basic_authentication_id は基本認証トランスポート ID です。
- basic_authentication_password は基本認証トランスポート・パスワードです。
- SSL_alias では、ポートの SSL 別名が識別されます。
- overridden_endpoint は、現行のエンドポイントをオーバーライドするために使用されるエンドポイントの名前です。
- overridden_binding_namespace では、ポートとともに使用する WSDL ファイル・バインディング名前空間
URI を指定します。
- $AdminConfig save コマンドを使用して構成変更を保存します。
タスクの結果
Web サービス・クライアント・ポートに関連付けられているクライアント・ポート情報が構成されます。
例
$AdminApp installInteractive MultiEjbJar.ear {-WebServicesClientBindPortInfo {{ejbclientonly.jar Exchange service/StockQuoteService StockQuote 6000 jsmith js9password level3ssl
http://fastball.houston.ibm.com/newURL http://fastball.houston.ibm.com/newBindName}}
{ejbclientonly.jar Exchange service/StockQuoteService StockQuote2 9000 {}{}{}{}{}}}
次のタスク
これで、その他の構成を完了したり、アプリケーションを開始または再始動したり、Web サービスの期待される動作を確認することができます。