43.10. 핸들러를 사용하도록 끝점 구성

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

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

예 43.14. “소비자에 핸들러 체인 추가” 소비자에 처리기 체인을 추가하기 위한 코드를 보여줍니다.

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. “소비자에 핸들러 체인 추가” 의 코드는 다음을 수행합니다.

핸들러를 인스턴스화합니다.

List 오브젝트를 생성하여 체인을 유지합니다.

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

프록시에서 DefaultBindingImpl 오브젝트로 바인딩 오브젝트를 가져옵니다.

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

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

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

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

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

예 43.15. “Handler Chain을 로드하는 서비스 구현” 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
{
...
}

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

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

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

handler-chain 요소는 단일 handler 요소를 자식으로 사용하는 경우에만 필요합니다. 그러나 전체 처리기 체인을 정의하는 데 필요한 만큼의 처리기 요소를 지원할 수 있습니다. 체인의 핸들러는 처리기 체인 정의에서 지정된 순서대로 실행됩니다.

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

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>