웹 서비스 엔드포인트 URL 단편 특성 파일에 대한 작업

특성 파일을 사용하여 HTTP, SOAP 및 JMS(Java™ Message Service)를 통하거나 직접 엔터프라이즈 Bean으로 액세스한 웹 서비스에 대한 엔드포인트 URL 단편을 관리 또는 변경할 수 있습니다. URL 단편은 공개된 WSDL(Web Services Description Language) 파일에 포함된 완전한 웹 서비스 엔드포인트 주소를 구성하는 데 사용됩니다.

시작하기 전에

엔드포인트 URL 단편은 웹 서비스 애플리케이션의 선택적 메타데이터입니다. 관리 콘솔 또는 특성 파일을 사용하여 URL 단편을 구성 및 관리할 수 있습니다. URL 단편을 조회하려면 관리 콘솔 또는 applyConfigProperties 명령을 사용하여 먼저 URL 단편을 설정해야 합니다. 관리 콘솔 또는 특성 파일을 사용하여 URL 단편을 처음으로 설정한 후, 특성 파일 또는 관리 콘솔을 사용하여 웹 서비스 엔드포인트 URL 단편을 수정할 수 있습니다.

관리 콘솔을 사용하여 URL 단편 설정에 대해 살펴보려면 HTTP 바인딩에 대한 엔드포인트 URL 정보 구성 또는 JMS 바인딩에 대한 엔드포인트 URL 정보 구성에 대한 정보를 참조하십시오.

이 태스크 정보

버전 8.0 이상에서는 특성 파일을 사용하여 HTTP, SOAP 및 JMS(Java Message Service)를 통하거나 직접 엔터프라이즈 Bean으로 액세스한 웹 서비스에 대한 엔드포인트 URL 단편을 관리할 수 있습니다.

각 웹 서비스 모듈에서 사용할 엔드포인트 URL의 일부를 지정할 수 있습니다. 지정한 부분은 WSDL 파일 공개 시 실제 엔드포인트 URL을 작성하는 데 사용됩니다. 공개된 WSDL 파일에서 대상 엔드포인트 주소를 정의하는 URL은 포트 soap:address 요소의 위치 속성에 있습니다. 이 페이지는 JAX-WS(Java API for XML-Based Web Services) 및 JAX-RPC(Java API for XML-based RPC) 웹 서비스에 모두 적용됩니다.

웹 서비스 엔드포인트 URL 단편 특성은 애플리케이션 특성 파일에 대한 확장자입니다. 명령을 사용하여 애플리케이션에 대한 특성 파일을 가져오는 경우 다른 애플리케이션 특성과 함께 엔드포인트 URL 단편도 가져옵니다. 프로시저에 설명된 대로 applyConfigProperties, validateConfigProperties 및 deleteConfigProperties 명령을 사용하여 웹 서비스 애플리케이션에서 엔드포인트 URL 단편을 업데이트, 유효성 검증 및 삭제하십시오.

프로시저

  1. 특성 파일을 추출하십시오.
    예를 들어, 애플리케이션의 특성인 sampleApplication을 추출하려면 extractConfigProperties 명령을 사용합니다.
    AdminTask.extractConfigProperties(['-propertiesFileName', 'myProperties.props', '-configData', 'Deployment=sampleApplication' ])
    이전에 웹 서비스 엔드포인트 URL 단편을 구성한 경우, 시스템에서는 특성 파일을 추출하고 결과에 다음 예에서 표시하는 것처럼 엔드포인트 URL 단편 섹션이 포함됩니다.
    #
    # CWSAD0103I: URLPrefixMap Section: module=TestApp.jar
    #
    ResourceType=Application
    ImplementingResourceType=Application
    ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
    ExtensionId=ApplicationWebServicesExtension
    #
    
    #
    #Properties
    http=http://myhostname:80
    module=TestApp.jar
  2. 특성 파일의 새 인스턴스를 작성하십시오.
    기존 URL 단편 특성을 수정하거나 새 특성을 작성한 경우 다음 명령을 사용하여 URL 단편 특성을 적용하십시오. 이 명령은 지정한 애플리케이션에서 해당 메타데이터를 작성 또는 업데이트합니다. 이 예제에서 선택적 -reportFileName 매개변수는 명령에서 보고서를 생성하도록 지정하는 데 사용됩니다.
    AdminTask.applyConfigProperties('[-propertiesFileName myProperties.props -reportFileName report.txt ]')
  3. 특성 파일의 유효성을 검증하십시오.
    validateConfigProperties 명령은 특성 파일의 특성 이름 및 값에 대한 유효성을 검증합니다. 모든 이름 및 값이 유효하면 해당 명령의 결과는 true입니다. 그렇지 않으면 이 명령은 false 값을 리턴합니다. 예를 들어, 다음과 같습니다.
    AdminTask.validateConfigProperties(['-propertiesFileName', 'myProperties.props', '-reportFileName', 
    'report.txt']) 
  4. 특성 파일을 삭제하십시오.

    deleteConfigProperties 명령이 호출되면 이 명령은 특성 파일 내에 지정된 모든 특성을 삭제합니다. 이전에 추출한 특성 파일로 시작하는 경우 deleteConfigProperties 명령을 적용하려는 섹션을 제외한 모든 섹션을 특성 파일 내에서 제거하십시오. 예를 들어, URL 접두부 맵을 삭제하려면 URLPrefix 맵 섹션을 제외한 모든 섹션을 추출된 특성 파일에서 제거하십시오. 이 때, 변수를 사용하는 경우에는 환경 변수 섹션도 제외될 수 있습니다.

    deleteConfigProperties 명령은 특성 파일에 지정된 특성을 삭제합니다. 예를 들어, 다음과 같습니다.
    AdminTask.deleteConfigProperties(['-propertiesFileName', 'myProperties.props', '-reportFileName',
     'report.txt']) 

    다음 myProperties.txt 파일은 TestApp.jar 모듈의 http URL 접두부 맵 삭제를 수행하는 데 사용할 수 있는 특성의 예입니다.

    #
    # CWSAD0103I: URLPrefixMap Section: module=TestApp.jar
    #
    ResourceType=Application
    ImplementingResourceType=Application
    ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
    ExtensionId=ApplicationWebServicesExtension
    #
    
    #
    #Properties
    http=http://myhostname:80
    module=TestApp.jar
    #
    #
    EnvironmentVariablesSection
    #
    #
    #Environment Variables
    applicationName=TestApp
    cellName=XYZNode01Cell
    serverName=server1
    nodeName=XYZNode01

결과

웹 서비스 특성 파일을 사용하여 다른 프로토콜의 웹 서비스 엔드포인트 URL 단편을 조회, 구성 및 관리할 수 있습니다.


주제 유형을 표시하는 아이콘 태스크 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_wbs_endptURL_prop
파일 이름:txml_wbs_endptURL_prop.html