Home » xml-commons-external-1.4.01-src » javax » xml » rpc » handler » [javadoc | source]
public interface: HandlerChain [javadoc | source]

All Implemented Interfaces:

This interface 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.
Method from javax.xml.rpc.handler.HandlerChain Summary:
destroy,   getRoles,   handleFault,   handleRequest,   handleResponse,   init,   setRoles
Method from javax.xml.rpc.handler.HandlerChain Detail:
 public  void destroy()
    Indicates the end of lifecycle for a HandlerChain.
 public String[] getRoles()
    Gets SOAP actor roles registered for this HandlerChain at this SOAP node. The returned array includes the special SOAP actor next.
 public boolean handleFault(MessageContext msgContext)
    The handleFault method initiates the SOAP fault processing for this handler chain.
 public boolean handleRequest(MessageContext msgContext)
    The handleRequest method initiates the request processing for this handler chain.
 public boolean handleResponse(MessageContext msgContext)
    The handleResponse method initiates the response processing for this handler chain.
 public  void init(Map config)
    Initializes the configuration for a HandlerChain.
 public  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.