pt.digitalis.dif.controller.interfaces
Interface IDIFDispatcher

All Known Implementing Classes:

AbstractDIFDispatcher

public interface IDIFDispatcher

Defines a default interface for DIFDispatchers.

Author:

Pedro Viegas pviegas@digitalis.pt

See Also:

AbstractDIFDispatcher

Created on:

Dec 11, 2007

Method Summary

DIFResponse	dispatch(IDIFRequest difRequest) This method serves as an interface between the AbstractDIFDispatcher and the calling AbstractChAL.
String	getChannelID()

Method Detail

dispatch

DIFResponse dispatch(IDIFRequest difRequest)
                     throws BusinessFlowException,
                            ControllerException

This method serves as an interface between the AbstractDIFDispatcher and the calling AbstractChAL. It is invoked by the AbstractChAL on a AbstractDIFDispatcher object. The method verifies the request's integrity, generates the appropriate context and schedules the request for service. When the execution is finished it returns the response to the AbstractChAL. If some step on the execution flow doesn't happen as expected, an exception is raised.

Parameters:

difRequest - The AbstractChAL-originated DIFRequest object

Returns:

The response object to be delivered to the calling AbstractChAL

Throws:

BusinessFlowException - when an exception is thrown by the stage's init/execute steps

ControllerException - when any runtime exception is thrown in a controller step

getChannelID

String getChannelID()

Returns:

the ID of the Channel this AbstractChAL manages