Name
HandlerChain
Synopsis
public interface HandlerChain extends java.util.List { // Public Instance Methods public abstract void destroy( ); public abstract String[ ] getRoles( ); public abstract boolean handleFault(MessageContextcontext
); public abstract boolean handleRequest(MessageContextcontext
); public abstract boolean handleResponse( MessageContextcontext
); public abstract void init( Mapconfig
); public abstract void setRoles(String[ ]soapActorNames
); }
A HandlerChain
is a list of
Handler
s configured to operate on either the
client or server side of a SOAP message path. The configuration
information required to build a HandlerChain
is
held in a HandlerRegistry
, the content of which
may be created at the same time as client-side tools or server-side
ties are generated, or which may be installed by application code at
runtime.
The handleFault( )
, handleRequest( )
, and handleResponse( )
methods are
called to pass a SOAP fault, request, or response message to each
Handler
within the chain in turn, resulting in the
Handler
methods of the same name being called in
sequence. Under some circumstances, the message does not fully
traverse the message path, as described in the reference entry for
Handler
, earlier in this chapter. These methods
return true if the message is completely processed, or false if a
handler in the chain caused message processing to be aborted.
The getRoles( )
method returns an array of strings that correspond to the URIs of the SOAP actors on behalf of which ...
Get Java Web Services in a Nutshell now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.