org.jboss.axis
Class FaultableHandler

java.lang.Object
  extended byorg.jboss.axis.handlers.BasicHandler (src) 
      extended byorg.jboss.axis.FaultableHandler
All Implemented Interfaces:
Handler (src)

public class FaultableHandler
extends BasicHandler (src)

A FaultableHandler is essentially a wrapper for any other Handler which provides flexible fault handling semantics.


Field Summary
protected  Handler (src) workHandler
           
 
Fields inherited from class org.jboss.axis.handlers.BasicHandler (src)
makeLockable, name, options
 
Constructor Summary
FaultableHandler(Handler (src)  workHandler)
          Constructor
 
Method Summary
 boolean canHandleBlock(QName (src)  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 init()
          Stubbed-out methods.
 void invoke(MessageContext (src)  msgContext)
          Invokes the specified handler.
 void onFault(MessageContext (src)  msgContext)
          Some handler later on has faulted so we need to process the fault.
 
Methods inherited from class org.jboss.axis.handlers.BasicHandler (src)
generateWSDL, getDeploymentData, getName, getOption, getOptions, getUnderstoodHeaders, initHashtable, setName, setOption, setOptionDefault, setOptions, setOptionsLockable
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

workHandler

protected Handler (src)  workHandler
Constructor Detail

FaultableHandler

public FaultableHandler(Handler (src)  workHandler)
Constructor

Parameters:
workHandler - the Handler we're going to wrap with Fault semantics.
Method Detail

init

public void init()
Description copied from class: BasicHandler (src)
Stubbed-out methods. Override in your child class to implement any real behavior.

Specified by:
init in interface Handler (src)
Overrides:
init in class BasicHandler (src)

cleanup

public void cleanup()
Description copied from interface: Handler (src)
Cleanup is called when the chain containing this Handler object is done processing the chain.

Specified by:
cleanup in interface Handler (src)
Overrides:
cleanup in class BasicHandler (src)

invoke

public void invoke(MessageContext (src)  msgContext)
            throws AxisFault (src) 
Invokes the specified handler. If there's a fault the appropriate key will be calculated and used to find the fault chain to be invoked. This assumes that the workHandler has caught the exception and already done its fault processing - as needed.

Specified by:
invoke in interface Handler (src)
Specified by:
invoke in class BasicHandler (src)
Throws:
AxisFault (src)

onFault

public void onFault(MessageContext (src)  msgContext)
Some handler later on has faulted so we need to process the fault.

Specified by:
onFault in interface Handler (src)
Overrides:
onFault in class BasicHandler (src)

canHandleBlock

public boolean canHandleBlock(QName (src)  qname)
Description copied from interface: Handler (src)
Can this Handler process this QName?

Specified by:
canHandleBlock in interface Handler (src)
Overrides:
canHandleBlock in class BasicHandler (src)