org.apache.axis2.engine
Class AbstractDispatcher

java.lang.Object
  org.apache.axis2.handlers.AbstractHandler
      org.apache.axis2.engine.AbstractDispatcher

All Implemented Interfaces:

Handler, java.io.Serializable

Direct Known Subclasses:

AddressingBasedDispatcher, RequestURIBasedDispatcher, SOAPActionBasedDispatcher, SOAPMessageBodyBasedDispatcher

public abstract class AbstractDispatcher

extends AbstractHandler

This the base class for all dispatchers. A dispatcher's task is to find the service for an incoming SOAP message.

In Axis2, a chain of dispatchers is setup. Each tries to dispatch and returns without throwing an exception, in case, it fails.

See Also:

Serialized Form

Field Summary

static javax.xml.namespace.QName

NAME Field NAME

Fields inherited from class org.apache.axis2.handlers.AbstractHandler

handlerDesc

Constructor Summary

AbstractDispatcher()

Method Summary

abstract AxisOperation	findOperation(AxisService service, MessageContext messageContext) Called by Axis Engine to find the operation.
abstract AxisService	findService(MessageContext messageContext) Called by Axis Engine to find the service.
abstract void	initDispatcher()
void	invoke(MessageContext msgctx) Invoke is called to do the actual work of the Handler object.

Methods inherited from class org.apache.axis2.handlers.AbstractHandler

cleanup, getHandlerDesc, getName, getParameter, init, revoke, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

NAME

public static final javax.xml.namespace.QName NAME

Field NAME

Constructor Detail

AbstractDispatcher

public AbstractDispatcher()

Method Detail

initDispatcher

public abstract void initDispatcher()

invoke

public void invoke(MessageContext msgctx)
            throws AxisFault

Description copied from interface: Handler

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 class's 'onFault' method will be called. Invoke should rethrow any exceptions it catches, wrapped in an AxisFault.

Parameters:

msgctx -

Throws:

AxisFault

findService

public abstract AxisService findService(MessageContext messageContext)
                                 throws AxisFault

Called by Axis Engine to find the service.

Parameters:

messageContext -

Returns:

Returns AxisService.

Throws:

AxisFault

findOperation

public abstract AxisOperation findOperation(AxisService service,
                                            MessageContext messageContext)
                                     throws AxisFault

Called by Axis Engine to find the operation.

Parameters:

service -

messageContext -

Returns:

Returns AxisOperation.

Throws:

AxisFault