HandlerChain (Apache Axis)

All Superinterfaces:

Collection, Iterable, List

All Known Implementing Classes:

HandlerChainImpl
```
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.

Version:

1.0

Method Summary

Methods
Modifier and Type	Method and Description
`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

- Method Detail
  - 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
  - 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
  - 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:
    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
  - init
```
void init(Map config)
```
    Initializes the configuration for a HandlerChain.
    
    Parameters:
    config - Configuration for the initialization of this handler chain
    
    Throws:
    
    JAXRPCException - if there is any error that prevents initialization
  - destroy
```
void destroy()
```
    Indicates the end of lifecycle for a HandlerChain.
    
    Throws:
    
    JAXRPCException - if there was any error that prevented destroy from completing
  - 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
  - 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

Interface HandlerChain

Method Summary

Methods inherited from interface java.util.List

Method Detail

handleRequest

handleResponse

handleFault

init

destroy

setRoles

getRoles