HandlerChain (Java EE 5 SDK)

Java

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


javax.xml.rpc.handler Interface HandlerChain

所有父接口:
Collection, Iterable, List

public interface HandlerChain
extends List

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.

版本:
1.0
作者:
Rahul Sharma
另请参见:
HandlerChain

方法摘要
 void destroy()
          Indicates the end of lifecycle for a HandlerChain.
 String[] getRoles()
          Gets SOAP actor roles registered for this HandlerChain at this SOAP node.
 boolean handleFault(MessageContext context)
          The handleFault method initiates the SOAP fault processing for this handler chain.
 boolean handleRequest(MessageContext context)
          The handleRequest method initiates the request processing for this handler chain.
 boolean handleResponse(MessageContext context)
          The handleResponse method initiates the response processing for this handler chain.
 void init(Map config)
          Initializes the configuration for a HandlerChain.
 void setRoles(String[] soapActorNames)
          Sets SOAP Actor roles for this HandlerChain.
 
Methods inherited from interface java.util.List
add, add, addAll, addAll, clear, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, retainAll, set, size, subList, toArray, toArray
 

方法详细信息

handleRequest

boolean handleRequest(MessageContext context)
The handleRequest method initiates the request processing for this handler chain.

参数:
context - MessageContext parameter provides access to the request SOAP message.
返回:
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.
抛出异常:
JAXRPCException - if any processing error happens
另请参见:
Handler.handleRequest(javax.xml.rpc.handler.MessageContext)

handleResponse

boolean handleResponse(MessageContext context)
The handleResponse method initiates the response processing for this handler chain.

参数:
context - MessageContext parameter provides access to the response SOAP message.
返回:
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.
抛出异常:
JAXRPCException - if any processing error happens
另请参见:
Handler.handleResponse(javax.xml.rpc.handler.MessageContext)

handleFault

boolean handleFault(MessageContext context)
The handleFault method initiates the SOAP fault processing for this handler chain.

参数:
context - MessageContext parameter provides access to the SOAP message.
返回:
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.
抛出异常:
JAXRPCException - if any processing error happens
另请参见:
Handler.handleFault(javax.xml.rpc.handler.MessageContext)

init

void init(Map config)
Initializes the configuration for a HandlerChain.

参数:
config - Configuration for the initialization of this handler chain
抛出异常:
JAXRPCException - If any error during initialization

destroy

void destroy()
Indicates the end of lifecycle for a HandlerChain.

抛出异常:
JAXRPCException - If any error during destroy

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.

参数:
soapActorNames - URIs for SOAP actor name
另请参见:
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.

返回:
String[] SOAP Actor roles as URIs
另请参见:
NamespaceConstants

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


提交错误或意见

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。深圳电信培训中心.徐海蛟老师教学参考.