org.jboss.axis
Interface Handler

All Known Subinterfaces:

Chain, TargetedChain

All Known Implementing Classes:

AxisClient, AxisEngine, AxisServer, BasicHandler, BasicProvider, DebugHandler, EchoHandler, EJBProvider, ErrorHandler, FaultableHandler, HTTPActionHandler, HTTPAuthHandler, HTTPSender, JavaProvider, JavaSender, JAXRPCHandler, JMSSender, LocalResponder, LocalSender, LogHandler, LogMessage, MD5AttachHandler, MsgProvider, RPCProvider, SimpleAuthenticationHandler, SimpleAuthorizationHandler, SimpleChain, SimpleSessionHandler, SimpleTargetedChain, SOAPService, Transport, URLMapper

public interface Handler

Author:

Doug Davis (dug@us.ibm.com)

Method Summary

boolean	canHandleBlock(javax.xml.namespace.QName qname) Can this Handler process this QName?
void	cleanup() Cleanup is called when the chain containing this Handler object is done processing the chain.
void	generateWSDL(MessageContext msgContext) Obtain WSDL information.
Element	getDeploymentData(Document doc) This will return the root element of an XML doc that describes the deployment information about this handler.
String	getName() Return the name (i.e.
Object	getOption(String name) Returns the option corresponding to the 'name' given
Hashtable	getOptions() Return the entire list of options
List	getUnderstoodHeaders() Return a list of QNames which this Handler understands.
void	init() Init is called when the chain containing this Handler object is instantiated.
void	invoke(MessageContext msgContext) Invoke is called to do the actual work of the Handler object.
void	onFault(MessageContext msgContext) Called when a subsequent handler throws a fault.
void	setName(String name) Set the name (i.e.
void	setOption(String name, Object value) Add the given option (name/value) to this handler's bag of options
void	setOptions(Hashtable opts) Sets a whole list of options

Method Detail

init

void init()

Init is called when the chain containing this Handler object is instantiated.

cleanup

void cleanup()

Cleanup is called when the chain containing this Handler object is done processing the chain.

invoke

void invoke(MessageContext msgContext)
            throws AxisFault

Invoke is called to do the actual work of the Handler object. If there is a fault during the processing of this method it is invoke's job to catch the exception and undo any partial work that has been completed. Once we leave 'invoke' if a fault is thrown, this classes 'onFault' method will be called. Invoke should rethrow any exceptions it catches, wrapped in an AxisFault.

Throws:

AxisFault

onFault

void onFault(MessageContext msgContext)

Called when a subsequent handler throws a fault.

canHandleBlock

boolean canHandleBlock(javax.xml.namespace.QName qname)

Can this Handler process this QName?

getUnderstoodHeaders

List getUnderstoodHeaders()

Return a list of QNames which this Handler understands. By returning a particular QName here, we are committing to fulfilling any contracts defined in the specification of the SOAP header with that QName.

setOption

void setOption(String name,
               Object value)

Add the given option (name/value) to this handler's bag of options

getOption

Object getOption(String name)

Returns the option corresponding to the 'name' given

setName

void setName(String name)

Set the name (i.e. registry key) of this Handler

getName

String getName()

Return the name (i.e. registry key) for this Handler

getOptions

Hashtable getOptions()

Return the entire list of options

setOptions

void setOptions(Hashtable opts)

Sets a whole list of options

getDeploymentData

Element getDeploymentData(Document doc)

This will return the root element of an XML doc that describes the deployment information about this handler. This is NOT the WSDL, this is all of the static internal data use by Axis - WSDL takes into account run-time information (like which service we're talking about) this is just the data that's stored in the registry. Used by the 'list' Admin function.

generateWSDL

void generateWSDL(MessageContext msgContext)
                  throws AxisFault

Obtain WSDL information. Some Handlers will implement this by merely setting properties in the MessageContext, others (providers) will take responsibility for doing the "real work" of generating WSDL for a given service.

Throws:

AxisFault