HandlerChain (Java EE 5)

HandlerChain 接口的实现类抽象化用来调用已注册处理程序的策略和机制。

The javax.xml.rpc.handler.HandlerChain represents a list of handlers. All elements in the HandlerChain are of the type javax.xml.rpc.handler.Handler.

An implementation class for the HandlerChain interface abstracts the policy and mechanism for the invocation of the registered handlers.

Version:

1.0

Author:

Rahul Sharma

See Also:

HandlerChain

public boolean handleRequest(MessageContext context)
handleRequest 方法初始化此处理程序链的请求处理。

context	MessageContext 参数提供对请求 SOAP 消息的访问。
return	一个 boolean 值，如果处理了链中的所有处理程序，则返回 true。如果链中某个处理程序从其 handleRequest 方法返回 false，则返回 false。
Throws	JAXRPCException: 如果发生处理错误
See also	handleRequest

英文文档：

handleRequest

boolean handleRequest(MessageContext context)

The handleRequest method initiates the request processing for this handler chain.

Parameters:

context - MessageContext parameter provides access to the request SOAP message.

Returns:

boolean Returns true if all handlers in chain have been processed. Returns false if a handler in the chain returned false from its handleRequest method.

Throws:

JAXRPCException - if any processing error happens

See Also:

Handler.handleRequest(javax.xml.rpc.handler.MessageContext)

public boolean handleResponse(MessageContext context)
handleResponse 方法初始化此处理程序链的响应处理。

context	MessageContext 参数提供对响应 SOAP 消息的访问。
return	一个 boolean 值，如果处理了链中的所有处理程序，则返回 true。如果链中某个处理程序从其 handleResponse 方法返回 false，则返回 false。
Throws	JAXRPCException: 如果发生处理错误
See also	handleResponse

英文文档：

handleResponse

boolean handleResponse(MessageContext context)

The handleResponse method initiates the response processing for this handler chain.

Parameters:

context - MessageContext parameter provides access to the response SOAP message.

Returns:

boolean Returns true if all handlers in chain have been processed. Returns false if a handler in the chain returned false from its handleResponse method.

Throws:

JAXRPCException - if any processing error happens

See Also:

Handler.handleResponse(javax.xml.rpc.handler.MessageContext)

public boolean handleFault(MessageContext context)
handleFault 方法初始化此处理程序链的 SOAP 默认处理。

context	MessageContext 参数提供对 SOAP 消息的访问。
return	一个 boolean 值，如果处理了链中的所有处理程序，则返回 true。如果链中某个处理程序从其 handleFault 方法返回 false，则返回 false。
Throws	JAXRPCException: 如果发生处理错误
See also	handleFault

英文文档：

handleFault

boolean handleFault(MessageContext context)

The handleFault method initiates the SOAP fault processing for this handler chain.

Parameters:

context - MessageContext parameter provides access to the SOAP message.

Returns:

boolean Returns true if all handlers in chain have been processed. Returns false if a handler in the chain returned false from its handleFault method.

Throws:

JAXRPCException - if any processing error happens

See Also:

Handler.handleFault(javax.xml.rpc.handler.MessageContext)

public void init(java.util.Map<K, V> config)
初始化 HandlerChain 的配置。

config	用于初始化此处理程序链的配置
Throws	JAXRPCException: 如果初始化期间出现错误

英文文档：

init

void init(Map config)

Initializes the configuration for a HandlerChain.

Parameters:

config - Configuration for the initialization of this handler chain

Throws:

JAXRPCException - If any error during initialization

public void destroy()
指示 HandlerChain 的生命周期结束。

Throws

JAXRPCException: 如果销毁过程中发生错误

英文文档：

destroy

void destroy()

Indicates the end of lifecycle for a HandlerChain.

Throws:

JAXRPCException - If any error during destroy

public void setRoles(String[] soapActorNames)
设置此 HandlerChain 的 SOAP 参与者角色。这指定了一个角色集，针对在此 SOAP 节点上处理的 SOAP 消息，此 HandlerChain 将实现这些角色。HandlerChain 假定的这些角色在通过 HandlerChain 处理个别 SOAP 消息期间不得改变。

HandlerChain 总是扮演特殊的 SOAP 参与者角色 next。关于这个特殊的 SOAP 参与者的 URI 名称，请参考 SOAP 规范。无需使用此方法设置这个特殊角色。

soapActorNames	SOAP 参与者名称的 URI
See also	javax.xml.rpc.NamespaceConstants

英文文档：

setRoles

void setRoles(String[] soapActorNames)

Sets SOAP Actor roles for this HandlerChain. This specifies the set of roles in which this HandlerChain is to act for the SOAP message processing at this SOAP node. These roles assumed by a HandlerChain must be invariant during the processing of an individual SOAP message through the HandlerChain.

A HandlerChain always acts in the role of the special SOAP actor next. Refer to the SOAP specification for the URI name for this special SOAP actor. There is no need to set this special role using this method.

Parameters:

soapActorNames - URIs for SOAP actor name

See Also:

NamespaceConstants

public String[] getRoles()
获取针对此 HandlerChain 在此 SOAP 节点注册的 SOAP 参与者角色。返回的数组包含特殊 SOAP 参与者 next。

return	URI 形式的 SOAP 参与者角色 (String[])
See also	javax.xml.rpc.NamespaceConstants

英文文档：

getRoles

String[] getRoles()

Gets SOAP actor roles registered for this HandlerChain at this SOAP node. The returned array includes the special SOAP actor next.

Returns:

String[] SOAP Actor roles as URIs

See Also:

NamespaceConstants

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