웹 서비스 주소 지정 어노테이션

WS-Addressing 스펙은 전송 중립 메커니즘을 제공하여 웹 서비스의 주소를 지정하고 단말간 주소 지정을 수월하게 합니다. JAX-WS 애플리케이션이 있는 경우, 사용자 코드에서 Java 어노테이션을 사용하여 런타임 시 WS-Addressing 동작을 지정할 수 있습니다.

WS-Addressing 어노테이션을 사용하여 WS-Addressing 지원을 사용하며, WS-Addressing 정보가 수신 메시지에서 필요한지 여부를 지정하고, 서비스가 지원하는 메시지 교환 패턴을 제어하며, 웹 서비스 조작이나 잘못된 응답과 연관될 조치를 지정할 수 있습니다.

다음 WS-Addressing 어노테이션은 WebSphere® Application Server에서 지원됩니다. 다르게 정의되지 않는 한 이 어노테이션은 JAX-WS 2.2 스펙에서 정의됩니다. JAX-WS 2.2 스펙은 JAX-WS 2.1 스펙 내의 기능을 대체하고 포함합니다. 전체 세부사항은 JAX-WS(Java API for XML-Based Web Services) 2.2 스펙을 참조하십시오.
javax.xml.ws.Action
웹 서비스 조작과 연관된 조치를 지정합니다.
  • JAX-WS 웹 서비스 개발에 대해 상향식 방법을 따르는 경우, wsgen 명령행 도구를 사용하여 Java 애플리케이션 코드에서 WSDL 문서를 생성할 수 있습니다. 그러나 이 속성을 WSDL 조작에 추가하려면, 구현 클래스에서 @Addressing 어노테이션도 지정해야 합니다. 생성된 WSDL 문서의 결과로 Action 어노테이션은 wsdl:operationinput messageoutput message 요소에 wsam:Action 속성을 갖게 됩니다. 또는 @Addressing 어노테이션을 사용하지 않으려면 조치 속성이 이미 정의된 사용자의 WSDL 문서를 제공할 수 있습니다.
  • JAX-WS 웹 서비스 개발에 대해 하향식 방법을 따르는 경우, wsimport 명령행 도구를 사용하여 기존 WSDL 문서에서 Java 애플리케이션 코드를 생성할 수 있습니다. 이런 경우, 결과 Java 코드는 올바른 Action 및 FaultAction 어노테이션을 포함합니다.
이 조치가 코드 어노테이션 또는 WSDL 문서에서 지정되지 않는 경우, Web Services Addressing 1.0 메타데이터 스펙에서 정의된 대로 기본 조치 패턴이 사용됩니다. 세부사항은 이 스펙을 참조하십시오.
참고: WebSphere Application Server 런타임 환경이 더 이상 사용되지 않는 wsaw:Action 속성을 지원하는 동안, 더 이상 사용되지 않는 wsaw:Action 속성을 포함한 이전 WSDL 문서에서 Java 코드를 생성하려고 하면, 이 속성은 무시됩니다.
javax.xml.ws.FaultAction
잘못된 응답에 추가된 조치를 지정합니다. 특정한 메소드와 함께 이 어노테이션을 사용하면, WS-Addressing FaultAction 확장자 속성이 해당 메소드에 맞는 WSDL 조작의 잘못된 요소에 추가됩니다. 이 속성을 WSDL 조작에 추가하려면, 구현 클래스에서 Addressing 어노테이션도 지정해야 합니다. Addressing 어노테이션을 사용하지 않으려면 조치 속성이 이미 정의된 사용자의 WSDL 문서를 제공할 수 있습니다. 이 어노테이션은 Action 어노테이션 내에 포함되어야 합니다.
WS-Addressing FaultAction 어노테이션을 포함하는 Java 애플리케이션 코드에서 생성된 WSDL 문서에는 wsdl:operationfault message 요소에 wsam:Action 속성이 있습니다.
참고: 사용자가 작성한 사용자 정의 Exception 클래스가 생성된 WSDL 문서에 성공적으로 맵핑되는지 확인하려면, java.lang.RuntimeException 클래스 대신 java.lang.Exception 클래스를 확장하십시오.
javax.xml.ws.soap.Addressing
이 서비스가 WS-Addressing 지원을 사용하도록 지정합니다. 서비스 구현 Bean에서만 이 어노테이션을 사용할 수 있습니다. 서비스 엔드포인트 인터페이스에서 이를 사용할 수 없습니다.
com.ibm.websphere.wsaddressing.jaxws21.SubmissionAddressing
이 어노테이션은 JAX-WS 스펙의 IBM 구현 일부입니다. 이 어노테이션은 이 서비스가 2004/08 WS-Addressing 스펙에 대한 WS-Addressing 지원을 사용하도록 지정합니다. 서비스 구현 Bean에서만 이 어노테이션을 사용할 수 있습니다. 서비스 엔드포인트 인터페이스에서 이를 사용할 수 없습니다.

코드 예제를 포함한 Addressing 및 SubmissionAddressing 어노테이션에 대한 자세한 정보는 주소 지정 어노테이션을 사용하여 JAX-WS 애플리케이션에 대한 웹 서비스 주소 지정 지원 사용을 참조하십시오.

다음 예제 코드는 Action 어노테이션을 사용하여 호출될 호출 조작(input) 및 응답 메시지에 추가되는 조치(output)를 정의합니다. 결함이 발생하는 경우, 예는 FaultAction 어노테이션을 사용하여 응답 메시지에 추가된 조치를 지정하는 데도 사용됩니다.
@WebService(name = "Calculator")
public interface Calculator {
   ...
  	 @Action(
      input="http://calculator.com/inputAction",
      output="http://calculator.com/outputAction",
      fault = { @FaultAction(className=AddNumbersException.class, 
                value="http://calculator.com/faultAction") 
      }
   )
   public int add(int value1, int value2) throws AddNumbersException {
      return value1 + value2;
   }
}
도구를 사용하여 코드에서 서비스 아티팩트를 생성하는 경우, 이전 예에서 생성된 WSDL 태그는 다음과 같습니다.
<definitions targetNamespace="http://example.com/numbers" ...>
   ...
   <portType name="AddPortType">
      <operation name="Add">
         <input message="tns:AddInput" name="Parameters"
                         wsam:Action="http://calculator.com/inputAction"/>
         <output message="tns:AddOutput" name="Result"
           	               wsam:Action="http://calculator.com/outputAction"/>
         <fault message="tns:AddNumbersException" name="AddNumbersException"
           	              wsam:Action="http://calculator.com/faultAction"/>
      </operation> 
    <portType>
    ...
<definitions>

주제 유형을 표시하는 아이콘 개념 주제



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