javax.xml.rpc.handler
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.
Method Summary | |
---|---|
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 . |
Throws: javax.xml.rpc.JAXRPCException if there was any error that prevented destroy from completing
next
.Returns: String[] SOAP Actor roles as URIs
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: javax.xml.rpc.JAXRPCException if any processing error happens
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: javax.xml.rpc.JAXRPCException if any processing error happens
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: javax.xml.rpc.JAXRPCException if any processing error happens
Parameters: config Configuration for the initialization of this handler chain
Throws: javax.xml.rpc.JAXRPCException if there is any error that prevents initialization
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