웹 서비스 주소 지정 API

이 제품에서는 WSRF(웹 서비스 자원 프레임워크) 애플리케이션의 개발자를 비롯하여 애플리케이션 개발자가 웹 서비스 자원 인스턴스에 대한 참조를 작성하고 대상을 지정할 수 있도록 애플리케이션 프로그래밍 레벨의 인터페이스를 제공합니다. 시스템 프로그래머인 경우 일부 이러한 인터페이스와 함께 웹 서비스 주소 지정(WS-Addressing) 시스템 프로그래밍 인터페이스를 사용할 수 있습니다.

JAX-WS 2.1 API

이 제품의 표준 JAX-WS 2.1 API는 javax.xml.ws.wsaddressing 패키지에 들어 있습니다. 이러한 API에 대한 자세한 정보는 JAX-WS 2.1 API 문서를 참조하십시오.

이 제품의 표준 JAX-WS 2.1 API 구현에는 com.ibm.websphere.wsaddressing.jaxws21 패키지의 API(Application Programming Interface)도 포함됩니다. 이러한 API에 대한 세부사항은 이 문서의 생성된 API 문서에 있습니다. 이 API를 사용하면 특정 클래스를 사용하여 다음 목적을 달성할 수 있습니다.
  • 2004/08 WS-Addressing 스펙을 준수하는 엔드포인트를 나타내려면 com.ibm.websphere.wsaddressing.jaxws21.SubmissionEndpointReference 클래스를 사용하십시오.
  • SubmissionEndpointReference 인스턴스를 작성하여 엔드포인트 참조를 생성하는 웹 서비스 이외의 웹 서비스에서 2004/08 엔드포인트를 나타내려면 com.ibm.websphere.wsaddressing.jaxws21.SubmissionEndpointReferenceBuilder 클래스를 사용하십시오.
  • W3CEndpointReference 또는 SubmissionEndpointReference 인스턴스에 IBM 독점 WS-Addressing API를 사용하여 작성된 EndpointReference 인스턴스를 변환하려면 com.ibm.websphere.wsaddressing.jaxws21.EndpointReferenceCoverter 클래스를 사용하십시오. 이 클래스를 사용하여 EndpointReference 인스턴스의 변환을 되돌릴 수도 있습니다. instances.
  • 클라이언트에서 WS-Addressing을 사용하려면 com.ibm.websphere.wsaddressing.jaxws21.SubmissionAddressingFeature 클래스를 사용하고 서버에서 WS-Addressing을 사용하려면 어노테이션, @SubmissionAddressing을 사용하십시오.

IBM의 WS-Addressing API

이러한 API(Application Programming Interface)는 com.ibm.websphere.wsaddressing 패키지에 있으며 다음 다이어그램과 같이 요약할 수 있습니다. 또한 다이어그램은 JAX-WS 2.1 API의 클래스인 com.ibm.websphere.wsaddressing.jaxws21.EndpointReferenceConverter, javax.xml.ws.wsaddressing.W3CEndpointReference 및 com.ibm.websphere.wsaddressing.jaxws21.SubmissionEndpointReference를 보여줍니다.
Java 클래스 ` EndpointReferenceManager `에는 두 가지 메서드가 포함되어 있습니다: ` createEndpointReference `와 ` getReferenceParameterFromMessageContext `. 이 클래스에서는 EndpointReference(setReferenceParameter 메소드 포함), WSAConstants(WSADDRESSING_DESTINATION_EPR 상수 포함) 및 ReferenceParameterCreationException과 같은 서로 다른 3개의 클래스를 사용합니다. WSAConstants와 ReferenceParameterCreationException 는 모두 추가 클래스인 EndpointReferenceCreationException 를 사용합니다.
이 인터페이스는 다음 기능을 제공합니다.
  • com.ibm.websphere.wsaddressing.EndpointReferenceManager.createEndpointReference 인터페이스를 사용하여 WS-Addressing 엔드포인트 참조를 표시하는 com.ibm.websphere.wsaddressing.EndpointReference 인스턴스를 작성하는 메커니즘
  • 사용 중단된 기능: JAX-WS 애플리케이션에서 사용하기 위해 EndpointReference 인스턴스를 사용 중단된 클래스 com.ibm.websphere.wsaddressing.W3CEndpointReference 또는 com.ibm.websphere.wsaddressing.SubmissionEndpointReferences, 로 변환하는 데 사용되던 사용 중단된 클래스 com.ibm.websphere.wsaddressing.EndpointReferenceCoverter,.

    이러한 클래스는 com.ibm.websphere.wsaddressing.jaxws21 및 javax.xml.ws.wsaddressing.jaxws21에 포함된 동일한 이름(EndpointReferenceConverter, SubmissionEndpointReference 및 W3CEndpointReference)의 JAX-WS 2.1 클래스 지원에 더 이상 사용되지 않습니다(다이어그램 참조).

  • EndpointReference 인스턴스와 참조 매개변수를 연관시킬 수 있는 com.ibm.websphere.wsaddressing.EndpointReference.setReferenceParameter 메소드
  • EndpointReference 인스턴스에 따라 클라이언트가 해당 BindingProvider 요청 컨텍스트나 Stub 또는 Call 오브젝트를 구성할 수 있는 인터페이스. BindingProvider, Stub 또는 Call 오브젝트에서 수행되는 모든 호출은 후속으로 EndpointReference 인스턴스가 표시하는 엔드포인트에서 대상을 지정합니다. 이 동작을 수행하려면, BindingProvider 요청 컨텍스트나 Stub 또는 Call 오브젝트에서 com.ibm.websphere.wsaddressing.WSAConstants.WSADDRESSING_DESTINATION_EPR 특성을 적절한 EndpointReference 인스턴스로 설정하십시오.
  • com.ibm.websphere.EndpointReferenceManager.getReferenceParameterFromMessageContext 인터페이스를 통해 특정 자원 인스턴스와 메시지를 상관시키는 수신 메시지 컨텍스트와 연관된 개별 참조 매개변수를 확보하는 메커니즘