43.10. Handlers를 사용하도록 끝점 구성

처리기 체인을 소비자에 추가하려면 처리기 체인을 명시적으로 빌드해야 합니다. 그런 다음 서비스 프록시의 Binding 오브젝트에 처리기 체인을 직접 설정합니다.

사용자에게 처리기 체인을 추가하려면 다음을 수행합니다.

예 43.14. “소비자에 Handler 체인 추가” 사용자에게 처리기 체인을 추가하기 위한 코드를 표시합니다.

import javax.xml.ws.BindingProvider;
import javax.xml.ws.handler.Handler;
import java.util.ArrayList;
import java.util.List;

import org.apache.cxf.jaxws.binding.DefaultBindingImpl;
...
SmallNumberHandler sh = new SmallNumberHandler();
List<Handler> handlerChain = new ArrayList<Handler>();
handlerChain.add(sh);

DefaultBindingImpl binding = ((BindingProvider)proxy).getBinding();
binding.getBinding().setHandlerChain(handlerChain);

예 43.14. “소비자에 Handler 체인 추가” 의 코드는 다음을 수행합니다.

처리기를 인스턴스화합니다.

체인을 보유할 List 오브젝트를 만듭니다.

체인에 처리기를 추가합니다.

프록시에서 DefaultBindingImpl 개체로 Binding 개체를 가져옵니다.Gets the Binding object from the proxy as a DefaultBindingImpl object.

처리기 체인을 프록시의 바인딩에 할당합니다.

SEI 또는 구현 클래스를 @Handler Cryostat 주석으로 데코팅하여 서비스 공급자에 처리기 체인을 추가합니다. 주석은 서비스 공급자가 사용하는 처리기 체인을 정의하는 메타 데이터 파일을 가리킵니다.

서비스 공급자에 처리기 체인을 추가하려면 다음을 수행합니다.

javax.jws.Handler annotations 는 서비스 공급자의 구현 클래스를 분리합니다. 런타임에서 파일 속성으로 지정된 처리기 체인 구성 파일을 로드하도록 지시합니다.

주석의 file 속성은 로드할 처리기 구성 파일을 식별하는 두 가지 방법을 지원합니다.

예 43.15. “처리기 체인을 로드하는 서비스 구현” 에서는 handlers.xml 이라는 파일에 정의된 처리기 체인을 사용할 서비스 공급자 구현을 표시합니다. handlers.xml 은 서비스 공급자가 실행되는 디렉터리에 있어야 합니다.

import javax.jws.HandlerChain;
import javax.jws.WebService;
...

@WebService(name = "AddNumbers",
            targetNamespace = "http://apache.org/handlers",
            portName = "AddNumbersPort",
            endpointInterface = "org.apache.handlers.AddNumbers",
            serviceName = "AddNumbersService")
@HandlerChain(file = "handlers.xml")
public class AddNumbersImpl implements AddNumbers
{
...
}

처리기 구성 파일은 구현되는 XML 문법을 사용하여 처리기 체인을 정의합니다(Java EE용 웹 서비스, 버전 1.2). 이 문법은 http://java.sun.com/xml/ns/javaee 에 정의되어 있습니다.

처리기 구성 파일의 root 요소는 handler-chains 요소입니다. handler-chains 요소에는 하나 이상의 handler-chain 요소가 있습니다.

handler-chain 요소는 처리기 체인을 정의합니다. 표 43.1. “Server-Side Handler Chain을 정의하는 데 사용되는 요소” handler-chain 요소의 하위 요소에 대해 설명합니다.

handler-chain 요소는 단일 handler 요소를 하위로 보유하는 데만 필요합니다. 그러나 전체 처리기 체인을 정의하는 데 필요한 만큼의 처리기 요소를 지원할 수 있습니다. 체인의 처리기는 처리기 체인 정의에 지정된 순서로 실행됩니다.

protocol-binding 과 같은 다른 자식은 정의된 처리기 체인의 범위를 제한하는 데 사용됩니다. 예를 들어 service-name-pattern 요소를 사용하는 경우 처리기 체인은 WSDL 포트 요소가 지정된 WSDL 서비스 요소의 자식인 서비스 공급자에만 연결됩니다. 이러한 제한 하위 중 하나만 handler 요소에서 사용할 수 있습니다.

handler 요소는 처리기 체인에서 개별 처리기를 정의합니다. handler-class 하위 요소는 처리기를 구현하는 클래스의 정규화된 이름을 지정합니다. handler 요소에는 처리기의 고유 이름을 지정하는 선택적 handler-name 요소가 있을 수도 있습니다.

예 43.16. “처리기 구성 파일” 단일 처리기 체인을 정의하는 처리기 구성 파일을 표시합니다. 체인은 두 개의 처리기로 구성됩니다.

<handler-chains xmlns="http://java.sun.com/xml/ns/javaee"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                xsi:schemaLocation="http://java.sun.com/xml/ns/javaee">
  <handler-chain>
    <handler>
      <handler-name>LoggingHandler</handler-name>
      <handler-class>demo.handlers.common.LoggingHandler</handler-class>
    </handler>
    <handler>
      <handler-name>AddHeaderHandler</handler-name>
      <handler-class>demo.handlers.common.AddHeaderHandler</handler-class>
    </handler>
  </handler-chain>
</handler-chains>