javax.xml.rpc.handler
Interface HandlerChain

All Superinterfaces:
java.util.Collection, java.util.List

public interface HandlerChain
extends java.util.List

The javax.xml.rpc.handler.HandlerChain represents an ordered list of handlers. All elements in the HandlerChain are of the type javax.xml.rpc.handler.HandlerInfo.

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


Method Summary
 void destroy()
          Indicates the end of lifecycle for a HandlerChain.
 java.lang.String[] getRoles()
          Gets SOAP actor roles registered for this HandlerChain at this SOAP node.
 void handleRequest(MessageContext context)
          The handleRequest method initiates the request processing for this handler chain.
 void handleResponse(MessageContext context)
          The handleResponse method initiates the response processing for this handler chain.
 void init(java.util.Map config)
          Initializes the configuration for a HandlerChain.
 void setRoles(java.lang.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
 

Method Detail

handleRequest

public void 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.
Throws:
JAXRPCException - - if any processing error happens

handleResponse

public void 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.
Throws:
JAXRPCException - - if any processing error happens

init

public void init(java.util.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

destroy

public void destroy()
Indicates the end of lifecycle for a HandlerChain.
Throws:
JAXRPCException - - If any error during destroy

setRoles

public void setRoles(java.lang.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.

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

getRoles

public java.lang.String[] getRoles()
Gets SOAP actor roles registered for this HandlerChain at this SOAP node. The returned array includes the special SOAP actor next.


Copyright © 2001 Apache XML Project. All Rights Reserved.