javax.xml.rpc.handler
Interface HandlerChain
- List
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.
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.
|
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 .
|
destroy
public void destroy()
Indicates the end of lifecycle for a HandlerChain.
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
.
- String[] SOAP Actor roles as URIs
handleFault
public boolean handleFault(MessageContext context)
The handleFault
method initiates the SOAP
fault processing for this handler chain.
context
- MessageContext parameter provides access to the 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 handleFault method.
handleRequest
public boolean handleRequest(MessageContext context)
The handleRequest
method initiates the request
processing for this handler chain.
context
- MessageContext parameter provides access to
the request SOAP message.
- 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.
handleResponse
public boolean handleResponse(MessageContext context)
The handleResponse
method initiates the response
processing for this handler chain.
context
- MessageContext parameter provides access to the response
SOAP message.
- 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.
init
public void init(Map config)
Initializes the configuration for a HandlerChain.
config
- Configuration for the initialization of this handler
chain
setRoles
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.
soapActorNames
- URIs for SOAP actor name
Copyright B) 2005 Apache Web Services Project. All Rights Reserved.