HandlerRegistry (Java EE 5)

处理程序链是在每个服务端点的基础上注册的，正如端口的限定名称所指示的那样。getHandlerChain 返回指定服务端点的处理程序链（java.util.List 形式）。返回的处理程序链是使用 java.util.List 接口配置的。此列表中的每个元素都必须是 Java 类型 javax.xml.rpc.handler.HandlerInfo。

The javax.xml.rpc.handler.HandlerRegistry provides support for the programmatic configuration of handlers in a HandlerRegistry.

A handler chain is registered per service endpoint, as indicated by the qualified name of a port. The getHandlerChain returns the handler chain (as a java.util.List) for the specified service endpoint. The returned handler chain is configured using the java.util.List interface. Each element in this list is required to be of the Java type javax.xml.rpc.handler.HandlerInfo.

Version:

1.0

Author:

Rahul Sharma

See Also:

Service

public java.util.List<E> getHandlerChain(javax.xml.namespace.QName portName)
获取指定服务端点的处理程序链。返回的 List 用于配置此 HandlerRegistry 中的此特定处理程序链。此列表中的每个元素必须是 Java 类型 javax.xml.rpc.handler.HandlerInfo。

portName	目标服务端点的限定名称
return	java.util.List 处理程序链
Throws	IllegalArgumentException: 如果指定了无效的 portName

英文文档：

getHandlerChain

List getHandlerChain(QName portName)

Gets the handler chain for the specified service endpoint. The returned List is used to configure this specific handler chain in this HandlerRegistry. Each element in this list is required to be of the Java type javax.xml.rpc.handler.HandlerInfo.

Parameters:

portName - Qualified name of the target service endpoint

Returns:

java.util.List Handler chain

Throws:

IllegalArgumentException - If an invalid portName is specified

public void setHandlerChain(javax.xml.namespace.QName portName, java.util.List<E> chain)
设置指定服务端点的处理程序链（java.util.List 形式）。此列表中的每个元素必须是 Java 类型 javax.xml.rpc.handler.HandlerInfo。

portName	目标服务端点的限定名称
chain	表示处理程序链的配置的列表
Throws	JAXRPCException: 如果处理程序链的配置中存在错误
Throws	UnsupportedOperationException: 如果不支持此设置操作。执行此操作是为了避免重写预先配置的处理程序链。
Throws	IllegalArgumentException: 如果指定了无效的 portName

英文文档：

setHandlerChain

void setHandlerChain(QName portName,
                     List chain)

Sets the handler chain for the specified service endpoint as a java.util.List. Each element in this list is required to be of the Java type javax.xml.rpc.handler.HandlerInfo.

Parameters:

portName - Qualified name of the target service endpoint

chain - A List representing configuration for the handler chain

Throws:

JAXRPCException - If any error in the configuration of the handler chain

UnsupportedOperationException - If this set operation is not supported. This is done to avoid any overriding of a pre-configured handler chain.

IllegalArgumentException - If an invalid portName is specified

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.