net.sf.cuf.fw2

Class AbstractAppDc

java.lang.Object

net.sf.cuf.fw2.AbstractAppDc

All Implemented Interfaces:

AppEventSupport, Dc, AppDc, Disposable, SimpleLifeCycle

public abstract class AbstractAppDc
extends Object
implements AppDc

The AbstractAppDc implements the common stuff (AppEvent handling) of the AppDc interface. A project specific AppDc is usally derived from AbstractAppDc.

Field Summary

Fields

Modifier and Type	Field and Description
protected static List<Class<? extends AppEvent>>	BLOCKED_EVENTS A list of the events we do not forward but handle via our own AppEventManager.
protected AppEventManager	mAppEventManger Our app event manager.
protected AppEventSupport	mAppEventSupport The next object in the AppEvent responder chain.
protected DialogManager	mDialogManager The manager object that opens/closes dialogs.

Constructor Summary

Constructors

Constructor and Description
AbstractAppDc()

Method Summary

Methods

Modifier and Type	Method and Description
void	dispose(Map<String,? super Object> pArgs) Called from the application to to cleanup all resources.
Dc	getActiveDialog() Returns the active dialog.
List<Dc>	getActiveDialogs() Returns a list of the active dialogs.
void	init(Dc pParent, Map<String,? super Object> pArgs) This method is called by the Application during the initialisation phase of an application.
void	postAppEvent(AppEvent pAppEvent) Process/Dispatch an AppEvent.

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.sf.cuf.fw2.SimpleLifeCycle

canPassivate, doActivate, doPassivate

Field Detail

mAppEventManger

protected AppEventManager mAppEventManger

Our app event manager.

mAppEventSupport

protected AppEventSupport mAppEventSupport

The next object in the AppEvent responder chain.

mDialogManager

protected DialogManager mDialogManager

The manager object that opens/closes dialogs.

BLOCKED_EVENTS

protected static final List<Class<? extends AppEvent>> BLOCKED_EVENTS

A list of the events we do not forward but handle via our own AppEventManager.

Constructor Detail

AbstractAppDc

public AbstractAppDc()

Method Detail

init

public void init(Dc pParent,
        Map<String,? super Object> pArgs)

This method is called by the Application during the initialisation phase of an application.

Specified by:

init in interface Dc

Parameters:

pParent - null, because we are the top Dc

pArgs - variable argument list modeled as a key/value map, never null.

getActiveDialog

public Dc getActiveDialog()

Description copied from interface: AppDc

Returns the active dialog. If no dialog is active, null is returned, if there is more than one active dialog, it is application depended which dialog is returned. This method may either return a AppDc, DialogDc or a plain Dc object, depending on the applications architecure.

Specified by:

getActiveDialog in interface AppDc

Returns:

null or the active dialog

getActiveDialogs

public List<Dc> getActiveDialogs()

Description copied from interface: AppDc

Returns a list of the active dialogs. If there is no active dialog, the list is empty. The objects in the list may be any class derived from Dc.

Specified by:

getActiveDialogs in interface AppDc

Returns:

a list with the active dialogs, never null

postAppEvent

public void postAppEvent(AppEvent pAppEvent)

Process/Dispatch an AppEvent.

Specified by:

postAppEvent in interface AppEventSupport

Parameters:

pAppEvent - event that should be routed/processes

Throws:

IllegalArgumentException - if pAppEvent is null

dispose

public void dispose(Map<String,? super Object> pArgs)

Called from the application to to cleanup all resources. The base implementation does nothing.

Specified by:

dispose in interface Disposable

Parameters:

pArgs - arguments, key is a String, value is any suitable objekt for the key