HandlerRegistry (Java EE 5)

Java EE API

previous page next page

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.xml.rpc.handler Interface HandlerRegistry

All Superinterfaces:: Serializable

public interface HandlerRegistry
extends Serializable

Implements: java.io.Serializable

javax.xml.rpc.handler.HandlerRegistry 提供对 HandlerRegistry 中处理程序的编程配置的支持。

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

version	1.0
See also	javax.xml.rpc.Service

英文文档：

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

Method Summary
`List`	`getHandlerChain(QName portName)` Gets the handler chain for the specified service endpoint.
`void`	`setHandlerChain(QName portName, List chain)` Sets the handler chain for the specified service endpoint as a `java.util.List`.

Method Detail

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