AdminTask 오브젝트에 대한 WebServicesAdmin 명령 그룹

wsadmin 도구를 사용하여 보안을 구성하는 데 Jython 또는 Jacl 스크립트 언어를 사용할 수 있습니다. WebServicesAdmin 그룹에서 명령을 사용하여 모든 웹 서비스, 서비스 참조 및 속성을 나열하고, 특정 웹 서비스의 속성을 찾고, 웹 서비스 엔드포인트를 결정하고, 웹 서비스의 오퍼레이션 이름을 결정합니다.

설치된 웹 서비스에 대한 정보를 조회하려면 WebServicesAdmin 그룹의 명령을 사용하십시오. AdminTask 오브젝트에 대한 자세한 정보는 AdminTask 오브젝트에 대한 명령 정보를 참조하십시오.

다음 명령은 AdminTask 오브젝트의 WebServicesAdmin 그룹에 사용 가능합니다.

getWebService

getWebService 명령은 웹 서비스에 대한 속성을 검색합니다. 이 명령 엔터프라이즈 엔터프라이즈에만 적용됩니다.

대상 오브젝트

없음.

필수 매개변수

-application
배치된 엔터프라이즈 엔터프라이즈의 이름을 지정합니다 (문자열, 필수).
-module
모듈 이름을 지정합니다. (문자열, 필수).
-service
웹 서비스의 이름을 지정합니다. (문자열, 필수).

선택적 매개변수

-client
웹 서비스가 제공자 또는 클라이언트인지를 지정합니다. 기본값은 다음과 같습니다.false(서비스 제공자). 이 값이true, 명령은 웹 서비스 클라이언트만 반환합니다. (Boolean, 선택적)

리턴값

서비스 이름, 서비스의 제공자 또는 클라이언트 여부 및 서비스 유형을 포함하는 속성 목록을 나열합니다. 서비스 유형 속성은 서비스 프로바이더에만 적용 가능합니다.

일괄처리 모드 사용법 예제

Jython 문자열 사용:
AdminTask.getWebService('[-application application_name -module module_name -service webservice_name
 -client false]')
샘플 출력:
'[[service {https://www.ibm.com}service1][type JAX-WS][client false]]'

대화식 모드 예제 사용법

Jython 사용:
AdminTask.getWebService ('-interactive')

listServices

listServices 명령은 서비스, 엔드포인트 및 조작에 대한 구성을 조회합니다. 이 명령은 이 명령 그룹의 나머지 명령에 비해 보다 일반적인 조회 기능을 제공합니다. Java™ 애플리케이션 및 WSN(Web Services Notification) 클라이언트와 같은 기타 자산에도 적용할 수 있습니다.

대상 오브젝트

없음.

선택적 매개변수

-queryProps
관심 있는 서비스 제공자 또는 클라이언트를 찾는 데 사용되는 특성을 지정합니다. 예를 들어 다음과 같이 지정할 경우,[[type=JAX-WS][client=true]], 명령은 엔터프라이즈 애플리케이션의 각 JAX-WS 클라이언트 참조를 반환합니다. (특성, 선택적).
-queryProps 매개변수는 여러 특성을 허용합니다. 하나 이상의 특성을 사용하여 조회 기준을 지정할 수 있습니다. 서로 다른 자산 유형 간에 조회 특성을 혼합하지 마십시오. 예를 들어 다음과 같이 지정할 경우,application및bus, 명령이 오류를 보고합니다.
  • 엔터프라이즈 애플리케이션을 조회하려면 다음 특성을 -queryProps 매개변수와 함께 지정하십시오.
    표 1. 에 대한 속성 -queryProps 엔터프라이즈 애플리케이션용 매개변수 . 다음 특성을 사용하여 엔터프라이즈 애플리케이션을 조회하십시오.
    특성 및 값 설명
    assetType=J2EE Application 각 Java EE 애플리케이션을 조회합니다.
    application=application_name 특정 Java EE 애플리케이션을 조회합니다.
    module=module_name 특정 Java EE 애플리케이션 모듈을 조회합니다. 다음을 지정해야 합니다.application및module애플리케이션 모듈을 쿼리하는 속성입니다.
  • WSN 클라이언트를 조회하려면 다음 특성을 -queryProps 매개변수와 함께 지정하십시오.
    표 2. WSN 클라이언트를 쿼리하는 속성 . 다음 특성을 사용하여 WSN 클라이언트를 조회하십시오.
    특성 및 값 설명
    assetType=WSN Service 각 WSN 서비스 클라이언트를 조회합니다.
    bus=bus_name 특정 버스를 조회합니다.
    WSNService=WSN_service_name 특정 WSN 서비스를 조회합니다. 다음을 지정해야 합니다.bus및WSNService특정 WSN 서비스를 쿼리하는 속성입니다.
  • 전체 자산을 조회하려면 다음 특성을 -queryProps 매개변수와 함께 지정하십시오.
    표 3. 에 대한 속성 -queryProps 모든 자산을 쿼리하는 매개변수 . 다음 특성을 사용하여 전체 자산을 조회하십시오.
    특성 및 값 설명
    serviceType=service_type 서비스 유형별로 조회합니다. 지정JAX-WSXML 기반 웹 서비스 자산용 Java™ API를 쿼리합니다. 지정JAX-WS (WSN)쿼리하다 Web Services Notification 자산.
    client=Boolean 클라이언트 또는 제공자를 조회합니다. 지정true클라이언트에 대해 쿼리합니다. 지정false공급자를 쿼리합니다.
    service=service_name 특정 서비스에 대한 논리 엔드포인트 및 조작을 조회합니다.
  • client=true인 경우 모든 서비스 참조 또는 특정 서비스 참조를 조회하려면 다음 특성을 -queryProps 매개변수와 함께 지정하십시오.
    표 4. 에 대한 속성 -queryProps 서비스 참조를 쿼리하는 매개변수 . 다음 특성을 사용하여 서비스 클라이언트에 대한 모든 서비스 참조를 조회하십시오.
    특성 및 값 설명
    serviceRef=serviceref_name

    특정 서비스 참조를 조회합니다.

    별표(*)를 와일드카드 문자로 사용하여 일치하는 서비스 클라이언트의 모든 서비스 참조를 리턴하도록 지정할 수도 있습니다.
-expandResource
서비스 이름만 또는 서비스와 자세한 자원 정보를 리턴할지 여부를 지정합니다. 지정logicalEndpoint또는operation. 다음을 지정하는 경우logicalEndpoint값을 입력하면 명령은 일치하는 서비스와 서비스의 각 엔드포인트를 반환합니다. 다음을 지정하는 경우operation값을 입력하면 명령은 일치하는 서비스와 해당 엔드포인트 및 작업을 반환합니다. (문자열, 선택사항).
expandResource 매개변수를 사용하여 서비스 참조 아래 엔드포인트 및 오퍼레이션에 대한 자세한 자원 정보를 리턴할 수 있습니다.

리턴값

엔드포인트와 조작을 조회하는 경우 명령이 각 서비스에 대한 특성 목록 및 자세한 엔드포인트와 조작 정보를 리턴합니다.

일괄처리 모드 사용법 예제

다음 예에서는 각 서비스 공급자를 쿼리합니다.myApplication애플리케이션. 예제에서는 각 서비스에 대한 논리적 끝점을 반환합니다. -expandResources 매개변수는 다음과 같이 설정됩니다.logicalEndpoint, 다음 예제 출력에서 볼 수 있듯이:
[ [service {https://www.ibm.com}EchoService] [assetType [J2EE Application]]
 [client false] [application MyWSApplication] [module ServicesModule.war] [serviceType JAX-WS] ]
[ [assetType [J2EE Application]] [service {https://www.ibm.com}EchoService]
 [client false] [application MyWSApplication] [module ServicesModule.war] [serviceType JAX-WS] 
[logicalEndpoint EchoServicePort] ]

[ [service {https://www.ibm.com}PingService] [assetType [J2EE Application]]
 [client false] [application MyWSApplication] [module ServicesModule.war] [serviceType JAX-WS] ]
[ [assetType [J2EE Application]] [service {https://www.ibm.com}PingService]
 [client false] [application MyWSApplication] [module ServicesModule.war] [serviceType JAX-WS]
 [logicalEndpoint PingServicePort] ]
Jython 문자열 사용:
AdminTask.listServices('[-queryProps [[application MyWSApplication][client false]] -expandResource
 logicalEndpoint]')
Jython 목록 사용:
AdminTask.listServices(['-queryProps', '[[application myApplication][client false]]', '-expandResource',
 'logicalEndpoint'])

다음 예에서는 각 서비스 클라이언트를 쿼리합니다.myBus버스. 예제에는 -expandResource 매개변수가 지정되지 않았기 때문에 각 서비스 클라이언트에 대한 논리 엔드포인트나 조작이 리턴되지 않습니다.

Jython 문자열 사용:
AdminTask.listServices('[-queryProps [[bus myBus][client true]] ]')
Jython 목록 사용:
AdminTask.listServices(['-queryProps', '[[bus myBus][client true]]'])

다음 예제 조회 서비스에서는 JaxWSServicesSamples 애플리케이션의 각 서비스 클라이언트에 대해 testRef 이름을 참조합니다. 이 예제에서는 -expandResource 매개변수가 지정되어 있으므로 각 서비스 참조의 논리 엔드포인트 또는 연산에 대한 자세한 자원 정보를 리턴합니다.

Jython 문자열 사용:
AdminTask.listServices('[-queryProps [[client true] [application JaxWSServicesSamples] [module SampleClientSei.war]
 [serviceRef testRef] -expandResource logicalEndpoint]')
Jython 목록 사용:
AdminTask.listServices(['-queryProps', '[[application JaxWSServicesSamples][client true][module SampleClientSei.war]
[serviceRef testRef]', '-expandResource', 'logicalEndpoint'])
샘플 출력:
'[ [serviceRef testRef] [service {https://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 {https://www.ibm.com}TestService] [assetType [J2EE Application]] [logicalEndpoint portA] 
[application JaxWSServicesSamples] ]

[ [serviceRef testRef] [module SampleClientSei.war] [serviceType JAX-WS] [client true]
 [service {https://www.ibm.com/}TestService] [assetType [J2EE Application]] [logicalEndpoint portB]
 [application JaxWSServicesSamples] ]'

대화식 모드 예제 사용법

Jython 사용:
AdminTask.listServices('-interactive')

listWebServices

listWebServices 명령은 하나 또는 모든 애플리케이션에 대해 사용 가능한 웹 서비스 목록을 검색합니다. 애플리케이션 이름이 제공되지 않는 경우 명령은 모든 웹 서비스를 나열합니다. 이 명령 엔터프라이즈 엔터프라이즈에만 적용됩니다.

대상 오브젝트

없음.

필수 매개변수

없음.

선택적 매개변수

-application
배치된 엔터프라이즈 엔터프라이즈의 이름을 지정합니다 이 매개변수를 지정하지 않으면 명령은 셀에서 모든 웹 서비스를 리턴합니다 (문자열, 선택사항).
-client
웹 서비스가 제공자 또는 클라이언트인지를 지정합니다. 기본값은 다음과 같습니다.false(서비스 제공자). 이 값이true, 명령은 웹 서비스 클라이언트만 반환합니다. (Boolean, 선택적)

리턴값

지정된 애플리케이션의 모든 웹 서비스. 각 웹 서비스에 대해 명령은 다음 속성과 해당 값을 리턴합니다. 애플리케이션 이름, 모듈 이름, 서비스 이름, 웹 서비스의 서비스 제공자 또는 클라이언트 여부 및 서비스 유형입니다. 웹 서비스가 서비스 제공자인 경우에만 서비스 유형이 지정됩니다.

일괄처리 모드 사용법 예제

Jython 문자열 사용:
AdminTask.listWebServices('[-application application1 -client false]')
Jython 목록 사용:
AdminTask.listWebServices(['-application', 'application1', '-client', 'false'])
샘플 출력:
'[[service {https://www.ibm.com}service1][application application1][module webapp1.war][type JAX-WS][client false]]'

대화식 모드 예제 사용법

Jython 사용:
AdminTask.listWebServices('-interactive')

listWebServiceEndpoints

listWebServiceEndpoints 명령은 웹 서비스 논리 엔드포인트의 목록을 리턴합니다. 논리 엔드포인트 이름은 WSDL(Web Services Description Language) 문서의 포트 이름입니다. 이 명령 엔터프라이즈 엔터프라이즈에만 적용됩니다.

대상 오브젝트

없음.

필수 매개변수

-application
배치된 엔터프라이즈 엔터프라이즈의 이름을 지정합니다 (문자열, 필수).
-module
모듈 이름을 지정합니다. (문자열, 필수).
-service
웹 서비스의 이름을 지정합니다. (문자열, 필수).

선택적 매개변수

-client
웹 서비스가 제공자 또는 클라이언트인지를 지정합니다. 기본값은 다음과 같습니다.false(서비스 제공자). 이 값이true, 명령은 웹 서비스 클라이언트만 반환합니다. (Boolean, 선택적)

리턴값

지정된 웹 서비스에 대한 논리 엔드포인트 이름을 리턴합니다.

일괄처리 모드 사용법 예제

Jython 문자열 사용:
AdminTask.listWebServiceEndpoints('[-application application_name -module module_name 
-service webservice_name -client false]')
Jython 목록 사용:
AdminTask.listWebServiceEndpoints(['-application', 'application_name', '-module', 'module_name',
 '-service', 'webservice_name', '-client', 'false'])
샘플 출력:
'[[logicalEndpoint QuotePort01]]'

대화식 모드 예제 사용법

Jython 사용:
AdminTask.listWebServiceEndpoints('-interactive')

listWebServiceOperations

listWebServiceOperations 명령은 웹 서비스 조작의 목록을 리턴합니다. 이 명령 엔터프라이즈 엔터프라이즈에만 적용됩니다.

대상 오브젝트

없음.

필수 매개변수

-application
배치된 엔터프라이즈 엔터프라이즈의 이름을 지정합니다 (문자열, 필수).
-module
모듈 이름을 지정합니다. (문자열, 필수).
-service
웹 서비스의 이름을 지정합니다. (문자열, 필수).
-logicalEndpoint
WSDL(Web Services Description Language) 문서에 있는 포트 이름입니다 (문자열, 필수).

선택적 매개변수

-client
웹 서비스 종류(제공자 또는 클라이언트). 기본값은 다음과 같습니다.false(서비스 제공자). 이 값이true, 명령은 웹 서비스 클라이언트만 반환합니다. (Boolean, 선택적)

리턴값

지정된 웹 서비스에 대한 조작 이름을 리턴합니다.

일괄처리 모드 사용법 예제

Jython 문자열 사용:
AdminTask.listWebServiceOperations('[-application application_name -module 
module_name -service webservice_name -client false
 -logicalEndpoint endpoint_name]')
Jython 목록 사용:
AdminTask.listWebServiceOperations(['-application', 'application_name', '-module', 
'module_name', '-service', 'webservice_name', '-client',
 'false', '-logicalEndpoint', 'endpoint_name'])
샘플 출력:
'[[operation ivt_app_op1][operation ivt_app_op2]]'

대화식 모드 예제 사용법

Jython 사용:
AdminTask.listWebServiceOperations('-interactive')