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 对象。

添加处理程序到 链。

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

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

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

要将处理程序链添加到您执行以下操作的服务供应商中：

javax.jws.HandlerChain 注解 decorates service provider 的实施类。它指示运行时加载由其 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 服务）。这个mar在 http://java.sun.com/xml/ns/javaee 中定义。

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

handler-chain 元素定义处理程序链。表 43.1 “用于定义服务器范围处理程序链的元素” 描述 handler-chain 元素的子项。

handler-chain 元素只需要将单一 handler 元素用作子项。不过，它可以根据需要支持许多 处理程序 元素来定义完整的处理程序链。链中的处理程序按照处理程序链定义中指定的顺序执行。

其他子项（如 protocol-binding ）用于限制定义的处理器链的范围。例如，如果您使用 service-name-pattern 元素，处理程序链将仅附加到服务提供程序，其 WSDL 端口 元素是指定 WSDL 服务 元素的子级。您只能在 handler 元素中使用其中一个限制的 children。

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>