net.sf.cuf.examples.model.uc1

Class UseCase1Dc

java.lang.Object

net.sf.cuf.fw2.AbstractDialogDc

net.sf.cuf.examples.model.uc1.UseCase1Dc

All Implemented Interfaces:

AppEventSupport, Dc, DialogDc, Disposable, SimpleLifeCycle

public class UseCase1Dc
extends AbstractDialogDc
implements DialogDc

UseCase1Dc is the presentation component of a typical CRUD (Create, Read, Update, Delete) business application. It uses the net.sf.cuf.xfer library to do asynchronous data loading and uses the BlockEvent and ShowStatusEvent to provide the user with feedback. The quite complicated UI work is done in the presentation component (UseCase1Pc).

Field Summary

Fields inherited from class net.sf.cuf.fw2.AbstractDialogDc

mAppEventSupport, mDialogManager

Constructor Summary

Constructors

Constructor and Description
UseCase1Dc()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canPassivate() We can only passivate if there is no dirty data
void	dataLoaded(Response pResponse) Callback from the Request issued in loadData().
void	dataSaved(Response pResponse) Callback from the Request issued in saveData().
void	dispose(Map<String,? super Object> pArgs) Called from the dialog coordinator to tell the dialog to cleanup all resources.
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.
Object	getVisualPresentation() Called from the dialog coordinater in the initialized, active or passive state to get the visual representation for this dialog.
void	init(Dc pParent, Map<String,? super Object> pArgs) This method is called by the parent dialog controller during the initialisation phase of an application.
void	loadData() Method for our presentation to initiate the data loading.
void	monitorVMChange(ChangeEvent pEvent) Callback to test ValueModel callbacks via XML.
void	saveData() Method for our presentation to initiate the data saving.

Methods inherited from class net.sf.cuf.fw2.AbstractDialogDc

postAppEvent

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.appevent.AppEventSupport

postAppEvent

Constructor Detail

UseCase1Dc

public UseCase1Dc()

Method Detail

init

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

This method is called by the parent dialog controller during the initialisation phase of an application.

Specified by:

init in interface Dc

Overrides:

init in class AbstractDialogDc

Parameters:

pParent - our non-null parent

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

getVisualPresentation

public Object getVisualPresentation()

Called from the dialog coordinater in the initialized, active or passive state to get the visual representation for this dialog.

Specified by:

getVisualPresentation in interface DialogDc

Returns:

an object that represents the visual representation of this dialog

canPassivate

public boolean canPassivate()

We can only passivate if there is no dirty data

Specified by:

canPassivate in interface SimpleLifeCycle

Overrides:

canPassivate in class AbstractDialogDc

Returns:

true if there is no data to save

doActivate

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

Called from the dialog coordinator to tell the dialog to switch to the active state.

Specified by:

doActivate in interface SimpleLifeCycle

Parameters:

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

doPassivate

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

Called from the dialog coordinator to tell the dialog to switch to the passive state.

Specified by:

doPassivate in interface SimpleLifeCycle

Parameters:

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

dispose

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

Called from the dialog coordinator to tell the dialog to cleanup all resources. We only call dispose of our Pc.

Specified by:

dispose in interface Disposable

Overrides:

dispose in class AbstractDialogDc

Parameters:

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

loadData

public void loadData()

Method for our presentation to initiate the data loading. We block the gui, set the status and dispatch a LoadDataRequest in an other thread.

dataLoaded

public void dataLoaded(Response pResponse)

Callback from the Request issued in loadData(). We change the value model holding the data and the status line and unblock the gui.

Parameters:

pResponse - the response containing either the result or an error

saveData

public void saveData()

Method for our presentation to initiate the data saving. We block the gui, set the status and dispatch a SaveDataRequest in an other thread.

dataSaved

public void dataSaved(Response pResponse)

Callback from the Request issued in saveData(). We change the status line and unblock the gui.

Parameters:

pResponse - the response containing either the result or an error

monitorVMChange

public void monitorVMChange(ChangeEvent pEvent)

Callback to test ValueModel callbacks via XML.

Parameters:

pEvent - the change event