net.sf.cuf.fw2

Interface SimpleLifeCycle

All Known Subinterfaces:

AppDc, DialogDc

All Known Implementing Classes:

AbstractAppDc, AbstractDialogDc

public interface SimpleLifeCycle

The SimpleLifeCycle interface describes a part of a more complex lifecycle, and is used to encapsulate the common life cycle of AppDc and DialogDc.
The lifecycle that is described by the SimpleLifeCyce interface is shown below: doActivate() doPassivate() [initialized] -----------> [active] ------------> [passive] <------------ doActivate() The arguments of the doActivate() and doPassivate() calls may also be used to return stuff to the caller.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canPassivate() Test to check if a dialog in the active state can be moved to the passive state. The dialog may e.g.
void	doActivate(Map<String,? super Object> pArgs) Called from the dialog coordinator to tell the dialog to switch to the active state.
void	doPassivate(Map<String,? super Object> pArgs) Called from the dialog coordinator to tell the dialog to switch to the passive state.

Method Detail

canPassivate

boolean canPassivate()

Test to check if a dialog in the active state can be moved to the passive state.
The dialog may e.g. check if it has unsaved data and prompt the user for information how to proceed.
If the dialog returns true, it may be moved to the passive state by a call to doPassivate(), if it returns false, it will remain in the active state and no doPassivate() call will happen.

Returns:

true if the dialog can be passivated

doActivate

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

Called from the dialog coordinator to tell the dialog to switch to the active state. If the dialog is an modal dialog, this method returns after the dialog closed.

Parameters:

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

doPassivate

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

Called from the dialog coordinator to tell the dialog to switch to the passive state. If the dialog is a modal dialog, this method is called "inside" the doActivate() method.

Parameters:

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