wsadmin スクリプトによる Web サービスの照会
Jython または Jacl スクリプト言語を使用して、 wsadmin ツールにより Web サービス・プロパティーを照会することができます。WebServicesAdmin グループのコマンドを使用して、すべての Web サービス、サービス参照、およびサービス属性のリスト、特定の Web サービスの属性の検出、Web サービスのエンドポイントの判別、および Web サービスのオペレーション名の判別を行います。
始める前に
wsadmin Administrative Scripting プログラムは 2 つのスクリプト言語、Jacl と Jython をサポートしています。Jacl 構文は推奨されません。Jython スクリプト言語のみで書かれた例が含まれています。
WebServicesAdmin グループ内のコマンドの手順を実行する前に、wsadmin ツールを起動する必要があります。
このタスクについて
以下のコマンドを使用して、Web サービスおよび Web サービス属性を照会します。 NoItemFoundException エラーが表示される場合は、指定したアプリケーション、モジュール、 サービス、またはエンドポイントが見つかっていません。 すべてのパラメーターが正しいことを確認してください。
オプションで、WebServicesAdmin コマンド・グループ内の任意のコマンドのクライアント・パラメーターを指定できます。 クライアント・パラメーターでは、サービス・プロバイダーまたはサービス・クライアントのいずれを戻すかを示します。 サービス・プロバイダーを要求する場合は false を、 サービス・クライアントを要求する場合は true を、それぞれ指定します。
手順
- すべてのエンタープライズ・アプリケーションのすべてのインストール済み Web サービスの構成を照会します。 次のコマンドを入力します。 このコマンドのアプリケーション・パラメーターを指定する必要はありません。
このコマンドは、すべてのインストール済み Web サービスを戻します。 また、このコマンドは各 Web サービスのアプリケーション名、モジュール名、サービス名、およびサービス・タイプも戻します。AdminTask.listWebServices()
出力例:'[ [service {http://www.ibm.com}service1] [client false] [application application1] [module webapp1.war] [type JAX-WS] ]'
- 特定のエンタープライズ・アプリケーションのすべてのインストール済み Web サービスの構成を照会します。 次のコマンドを入力します。 その際、照会したいアプリケーションの名前を指定します。
このコマンドは、指定した application_name のすべてのインストール済み Web サービスを戻します。 また、このコマンドは各 Web サービスのアプリケーション名、モジュール名、サービス名、およびサービス・タイプも戻します。AdminTask.listWebServices('[–application application_name -client false]')
出力例:'[ [service {http://www.ibm.com}service1] [client false] [application application1] [module webapp1.war] [type JAX-WS] ]'
- エンタープライズ・アプリケーションの Web サービスの名前とタイプの構成を照会します。 次のコマンドを入力します。 その際、アプリケーション名、モジュール名、および Web サービス名を指定します。 client パラメーターはオプションです。
コマンドは、Web サービス名と Web サービスのタイプを戻します。AdminTask.getWebService('[–application application_name -module module_name -service webservice_name -client false]')
出力例:'[ [service {http://www.ibm.com}service1] [client false] [type JAX-WS] ]'
- エンタープライズ・アプリケーションの Web サービス・エンドポイントの構成を照会します。 論理エンドポイント名は、Web サービス記述言語 (WSDL) 文書内のポート名です。 次のコマンドを入力します。 その際、アプリケーション名、モジュール名、および Web サービス名を指定します。 client パラメーターはオプションです。
このコマンドは、Web サービスがインストールされるポートを戻します。AdminTask.listWebServiceEndpoints('[–application application_name -module module_name -service webservice_name -client false]')
出力例:'[logicalEndpoint QuotePort01]'
- エンタープライズ・アプリケーションの Web サービス・オペレーション名の構成を照会します。 次のコマンドを入力します。 その際、アプリケーション名、モジュール名、Web サービス名、およびエンドポイント名を指定します。 論理エンドポイント名は、Web サービス記述言語 (WSDL) 文書内のポート名です。 client パラメーターはオプションです。
このコマンドは、すべての Web サービス・オペレーションを戻します。AdminTask.listWebServiceOperations('[–application application_name -module module_name -service webservice_name -logicalEndpoint endpoint_name -client false]')
出力例:'[operation ivt_app_op1] [operation ivt_app_op2]'
- 各デプロイ済みアセットのサービス・プロバイダー、エンドポイント、およびオペレーションの構成を照会します。
listServices コマンドは、汎用的な照会機能を提供します。次のコマンドを使用して、エンタープライズ・アプリケーションおよび Web Services Notification (WSN) クライアントのサービス・プロバイダー、エンドポイント、およびオペレーションの情報を表示します。各パラメーターはオプションです。queryProps パラメーターを指定しない場合、コマンドは構成内の各サービス・プロバイダーを戻します。expandResources パラメーターを指定しない場合、コマンドからは各サービスの論理エンドポイントまたはオペレーションは戻されません。
次のコマンド例では、myApplication アプリケーションについて、 各サービス・プロバイダーおよび対応するエンドポイントを戻します。AdminTask.listServices('-queryProps "[[CompositionUnit=myApplication][client=false]" -expandResources endpoint']
次のコマンド例では、 セル内の各 JAX-WS サービス・プロバイダー、および対応するエンドポイントとオペレーションが戻されます。
このコマンドは、検索照会に一致するサービス・プロバイダーを戻します。AdminTask.listServices('[-queryProps "[[serviceType JAX-WS][client false]]"]')
出力例:'[ [service {http://www.ibm.com}EchoService] [assetType [J2EE Application]] [client false] [application WSSampleServicesSei] [module SampleServicesSei.war] [serviceType JAX-WS] ] [ [service {http://www.ibm.com}EchoService12] [assetType [J2EE Application]] [client false] [application WSSampleServicesSei] [module SampleServicesSei.war] [serviceType JAX-WS] ] [service {http://www.ibm.com}PingService] [assetType [J2EE Application]] [client false] [application WSSampleServicesSei] [module SampleServicesSei.war] [serviceType JAX-WS] ] [ [service {http://www.ibm.com}PingService12] [assetType [J2EE Application]] [client false] [application WSSampleServicesSei] [module SampleServicesSei.war] [serviceType JAX-WS]]'
listServices コマンドを使用して、サービス参照に関する情報を取得します。 serviceRef プロパティーと、listServices コマンドの queryProps パラメーターを使用して、すべてのサービス参照または特定のサービス参照を照会できます。このパラメーターは、サービス・クライアントにのみ適用されます。 サービス参照の名前として、アスタリスク (*) をワイルドカードとして指定すると、一致するサービス・クライアントのサービス参照がすべて返されます。また、対象のサービス参照の名前を指定することで、特定のサービス参照を照会することもできます。 エンドポイントおよびオペレーションの詳細なサービス参照情報を戻すには、expandResource プロパティーを指定します。
次のコマンド例では、セル内のサービス・クライアントおよびサービス参照がすべてリストされます。
このコマンドは、検索照会に一致するサービス参照を返します。AdminTask.listServices('[-queryProps [[client true] [serviceRef *]]]')
次のサンプル出力では、EchoService サービス・クライアントおよび Echoservice12 サービス・クライアントがリストに含まれます。これらのクライアントは、セル内にサービス参照を持っていません。ただし、TestService サービス・クライアントおよび TestService2 サービス・クライアントはサービス参照を持っています。サービス・クライアントのサービス参照ごとに、プロパティー・オブジェクトが 1 つあります。コンポーネント名は、EJB モジュールの場合にのみ使用できます。'[ [service {http://www.ibm.com}EchoService] [assetType [J2EE Application]] [client true] [application JaxWSServicesSamples] [module SampleClientSei.war] [serviceType JAX-WS] ] [ [service {http://www.ibm.com}EchoService12] [assetType [J2EE Application]] [client true] [application JaxWSServicesSamples] [module SampleClientSei.war] [serviceType JAX-WS] ] [ [service {http://www.ibm.com}TestService] [assetType [J2EE Application]] [client true] [application JaxWSServicesSamples] [module SampleClientSei.war] [serviceType JAX-WS] ] [ [serviceRef testRef] [assetType [J2EE Application]] [service {http://www.ibm.com}TestService] [client true] [application JaxWSServicesSamples] [module SampleClientSei.war] [serviceType JAX-WS] ] [ [service {http://www.ibm.com}TestService2] [assetType [J2EE Application]] [client true] [application JaxWSServicesSamples] [module SampleClientSei.war] [serviceType JAX-WS] ] [ [serviceRef testRef2] [assetType [J2EE Application]] [service {http://www.ibm.com}TestService2] [client true] [application JaxWSServicesSamples] [module SampleClientSei.war] [serviceType JAX-WS] ]
次のコマンド例では、エンドポイントおよび操作を展開することによって、特定のサービス参照がリストされます。
このコマンドは、testRef の指定されたサービス参照を返します。serviceRef プロパティーは、各プロパティー・オブジェクトに含まれます。以下に例を示します。AdminTask.listServices('[-queryProps [[client true] [application JaxWSServicesSamples] [module SampleClientSei.war] [serviceRef testRef] -expandResource logicalEndpoint]')
'[ [serviceRef testRef] [service {http://www.ibm.com}TestService] [assetType [J2EE Application]] [client true] [application JaxWSServicesSamples] [module SampleClientSei.war] [serviceType JAX-WS] ] [ [serviceRef testRef] [module SampleClientSei.war] [serviceType JAX-WS] [client true] [service {http://www.ibm.com}TestService] [assetType [J2EE Application]] [logicalEndpoint portA] [application JaxWSServicesSamples] ] [ [serviceRef testRef] [module SampleClientSei.war] [serviceType JAX-WS] [client true] [service {http://www.ibm.com}TestService] [assetType [J2EE Application]] [logicalEndpoint portB] [application JaxWSServicesSamples] ]'
次のコマンド例では、 セル内の各 WSN サービス・クライアント、および対応するエンドポイントとオペレーションが戻されます。
このコマンドは、検索照会に一致するサービス・プロバイダーを戻します。AdminTask.listServices('[-queryProps "[[serviceType [JAX-WS (WSN)]][clie nt true]]" -expandResource logicalEndpoint]')
出力例:'[ [service {http://www.ibm.com/websphere/wsn/out/remote-publisher}OutboundRemotePublisherService] [assetType [WSN Service]] [client true] [bus bus1] [WSNService wsn1] [serviceType [JAX-WS (WSN)]] ] [ [assetType [WSN Service]] [service {http://www.ibm.com/websphere/wsn/out/remote-publisher}OutboundRemotePublisherService] [bus bus1] [client true] [WSNService wsn1] [serviceType [JAX-WS (WSN)]] [logicalEndpoint OutboundRemotePublisherPort] ] [ [service {http://www.ibm.com/websphere/wsn/out/notification}OutboundNotificationService] [assetType [WSN Service]] [client true] [bus bus1] [WSNService wsn1] [serviceType [JAX-WS (WSN)]] ] [ [assetType [WSN Service]] [service {http://www.ibm.com/websphere/wsn/out/notification}OutboundNotificationService] [bus bus1] [client true] [WSNService wsn1] [serviceType [JAX-WS (WSN)]] [logicalEndpoint OutboundNotificationPort] ]'
サブトピック
AdminTask オブジェクトの WebServicesAdmin コマンド・グループ
Jython または Jacl スクリプト言語を使用すると、wsadmin ツールでセキュリティーを構成することができます。WebServicesAdmin グループのコマンドを使用して、すべての Web サービス、サービス参照、および属性のリスト、 特定 Web サービスの属性の検索、Web サービス・エンドポイントの判別、Web サービスのオペレーション名の判別を行います。


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_wsfpmanagews
ファイル名:txml_wsfpmanagews.html