public interface HandlerChain extends List
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.
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 . |
boolean handleRequest(MessageContext context)
handleRequest
method initiates the request
processing for this handler chain.context
- MessageContext parameter provides access to
the request SOAP message.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 happensboolean handleResponse(MessageContext context)
handleResponse
method initiates the response
processing for this handler chain.context
- MessageContext parameter provides access to the response
SOAP message.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 happensboolean handleFault(MessageContext context)
handleFault
method initiates the SOAP
fault processing for this handler chain.context
- MessageContext parameter provides access to the SOAP
message.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 happensvoid init(Map config)
config
- Configuration for the initialization of this handler
chainJAXRPCException
- if there is any error that prevents
initializationvoid destroy()
JAXRPCException
- if there was any error that
prevented destroy from completingvoid setRoles(String[] soapActorNames)
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 nameString[] getRoles()
next
.Copyright © The Apache Software Foundation. All Rights Reserved.