org.dmd.dmc.presentation

Class Tracker

java.lang.Object

org.dmd.dmc.presentation.Tracker

All Implemented Interfaces:

DmcPresentationTrackerIF

public class Tracker
extends Object
implements DmcPresentationTrackerIF

The Tracker implements the DmcPresentationTrackerIF interface and can be used to track the readiness and change status of one or more generated form bindings (that result from FormBindingDefinitions in Model View Whatever).

Simply set a tracker on your generated form bindings and then use components similar to the GxtCancel or GxtApply buttons (org.dmd.mvw.client.gxtforms.implementation) to allow users to submit changes or cancel any changes they've made.

Constructor Summary

Constructors

Constructor and Description
Tracker()

Method Summary

Modifier and Type	Method and Description
void	addChangeListener(DmcChangeListenerIF listener) Adds a listener that's interested in whether anything has changed.
void	addReadyListener(DmcReadyListenerIF listener) Adds a listener that's interested in the tracker's state of readiness.
void	addValueChangeListener(DmcValueChangeListenerIF listener) Adds a listener that's interested in any value change in a presenter.
boolean	debug()
void	debug(boolean d) Sets whether the tracker is in debug mode or not.
void	debug(String message) Log the specified debug message.
void	isNotReady(DmcPresentationIF dpi) Indicates that the presentation component is "not ready".
void	isReady(DmcPresentationIF dpi) Indicates that the presentation component is "ready".
void	reset() Calling this method will call the reset method on all presentations; this will cause them all to display their original values.
void	startTracking() Calling this method will cause the tracker to query all of its presentation implementations to determine their current state.
void	track(DmcPresentationIF dpi) Adds the specified presentation implementation to the tracker.
void	validateAll() When a form is first rendered, it's often convenient to force validation on all of the fields so that they can display whether or not they're mandatory i.e.

Methods inherited from class java.lang.Object

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

Constructor Detail

Tracker

public Tracker()

Method Detail

debug

public void debug(boolean d)

Description copied from interface: DmcPresentationTrackerIF

Sets whether the tracker is in debug mode or not.

Specified by:

debug in interface DmcPresentationTrackerIF

Parameters:

d - true for debug.

debug

public boolean debug()

Specified by:

debug in interface DmcPresentationTrackerIF

Returns:

the tracker's debug state.

debug

public void debug(String message)

Description copied from interface: DmcPresentationTrackerIF

Log the specified debug message.

Specified by:

debug in interface DmcPresentationTrackerIF

Parameters:

message - the message to be logged.

addReadyListener

public void addReadyListener(DmcReadyListenerIF listener)

Description copied from interface: DmcPresentationTrackerIF

Adds a listener that's interested in the tracker's state of readiness.

Specified by:

addReadyListener in interface DmcPresentationTrackerIF

addChangeListener

public void addChangeListener(DmcChangeListenerIF listener)

Description copied from interface: DmcPresentationTrackerIF

Adds a listener that's interested in whether anything has changed.

Specified by:

addChangeListener in interface DmcPresentationTrackerIF

addValueChangeListener

public void addValueChangeListener(DmcValueChangeListenerIF listener)

Description copied from interface: DmcPresentationTrackerIF

Adds a listener that's interested in any value change in a presenter.

Specified by:

addValueChangeListener in interface DmcPresentationTrackerIF

isNotReady

public void isNotReady(DmcPresentationIF dpi)

Description copied from interface: DmcPresentationTrackerIF

Indicates that the presentation component is "not ready". Exactly what "not ready" means is implementation specific.

Specified by:

isNotReady in interface DmcPresentationTrackerIF

isReady

public void isReady(DmcPresentationIF dpi)

Description copied from interface: DmcPresentationTrackerIF

Indicates that the presentation component is "ready". Exactly what "ready" means is implementation specific.

Specified by:

isReady in interface DmcPresentationTrackerIF

startTracking

public void startTracking()

Description copied from interface: DmcPresentationTrackerIF

Calling this method will cause the tracker to query all of its presentation implementations to determine their current state.

Specified by:

startTracking in interface DmcPresentationTrackerIF

track

public void track(DmcPresentationIF dpi)

Description copied from interface: DmcPresentationTrackerIF

Adds the specified presentation implementation to the tracker. The tracker should also set itself on the presentation by calling its setTracker() method.

Specified by:

track in interface DmcPresentationTrackerIF

reset

public void reset()

Description copied from interface: DmcPresentationTrackerIF

Calling this method will call the reset method on all presentations; this will cause them all to display their original values.

Specified by:

reset in interface DmcPresentationTrackerIF

validateAll

public void validateAll()

Description copied from interface: DmcPresentationTrackerIF

When a form is first rendered, it's often convenient to force validation on all of the fields so that they can display whether or not they're mandatory i.e. that they require a value. Calling this method will call isValid() on all DmcPresentationIF implementers being tracked.

Specified by:

validateAll in interface DmcPresentationTrackerIF