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 “将处理程序链添加到消费者” 中的代码执行以下操作：

实例化处理程序。

创建用于存放链的列表对象。

将处理程序添加到 链。

从代理获取 Binding 对象作为 DefaultBindingImpl 对象。

将处理程序链分配给代理的绑定。

您可以通过调整 SEI 或实施类及 @HandlerChain 注释来向服务提供商添加处理程序链。该注释指向一个 meta-data 文件，该文件定义供服务提供商使用的处理程序链。

在您进行以下的服务提供商中添加处理器链：

javax.jws.HandlerChain 注解 decorates 服务提供商的实施类。它指示运行时加载由其 file 属性指定的处理程序链配置文件。

该注解的 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 grammar 定义处理程序链，该链附带 JSR 109 (Java EE 版本 1.2 的 Web 服务)。这个 grammar 在 http://java.sun.com/xml/ns/javaee 中定义。

处理程序配置文件的 root 元素是 handler-chains 元素。handler-chains 元素具有一个或多个 handler-chain 元素。

handler-chain 元素定义处理程序链。表 43.1 “用于定义 Server-Side Handler 链的元素” 描述 handler-chain 元素的子项。

handler-chain 元素只需要将单个 handler 元素作为子项。但是，它可以根据需要支持任意数量的 处理程序 元素来定义完整的处理程序链。链中的处理程序按照处理程序链定义中指定的顺序执行。

协议绑定 等其他子项用于限制定义的处理程序链的范围。例如，如果您使用 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>