Package de.aristaflow.adept2.core.updatemanager

Interface UpdateManager

All Superinterfaces:

ADEPT2Service

All Known Implementing Classes:

PVPUpdateManager

public interface UpdateManager
extends ADEPT2Service

The IUpdateManager Interface specifies a way to receive notification when a tracked object is altered.
The purpose of this is to remove the burden of change-notification from the process model (i.e. Node, Edge, Process, ...) and place it on a an external component.
Instead ChangeOperations, which alter a Process, should notify the UpdateManager of all the objects that have been affected by the change. The UpdateManager will then take care to notify all graphical representations of these elements.
Preferably ChangeOperations will give detailed feedback as to which properties have actually been changed, so that updating the visual model can be done with minimal effort.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	UpdateManager.ActivityProperties
static class	UpdateManager.DataEdgeProperties
static class	UpdateManager.DataElementProperties
static class	UpdateManager.EdgeProperties
static class	UpdateManager.InstanceProperties	These constants are needed with subprocesses to signal the activation or termination of a subprocess instance.
static class	UpdateManager.NodeProperties
static class	UpdateManager.ProcessProperties
static class	UpdateManager.TransactionProperties	Enum for transaction events

Field Summary

Fields

Modifier and Type	Field	Description
static String	ACTIVITY_STATE
static int	DEFAULT_PRIORITY	The default priority of a listener.

Method Summary

Modifier and Type	Method	Description
void	addListener(Object what, ChangeListener callback)	Add callback as a new listener for what, using the default priority.
void	addListener(Object what, ChangeListener callback, int priority)	Add callback as a new listener for what
void	firePropertyChange(Object procElement, Object property)	Notify all interested parties of changes to a Process element
void	firePropertyChange(Object procElement, Object property, Object newValue)	Notify all interested parties of changes to a Process element
void	firePropertyChange(Object procElement, Object property, Object oldValue, Object newValue)	Notify all interested parties of changes to a Process element
void	removeListener(Object what, ChangeListener callback)	Remove a callback from the listener list for object what
void	sendPropertyChanges()	Send all queued events and flush the queue.

Methods inherited from interface de.aristaflow.adept2.base.service.ADEPT2Service

getLocalUris, getRelease, getRuntimeRequiredServices, getServiceInstanceName, getStartupRequiredServices, getURIs, init, ping, preShutdown, shutdown, start

Field Detail

DEFAULT_PRIORITY

static final int DEFAULT_PRIORITY

The default priority of a listener.

See Also:

Constant Field Values

ACTIVITY_STATE

static final String ACTIVITY_STATE

See Also:

Constant Field Values

Method Detail

addListener

void addListener(Object what,
                 ChangeListener callback)

Add callback as a new listener for what, using the default priority.

Parameters:

what - The object that is to be monitored

callback - The object receiving notification

addListener

void addListener(Object what,
                 ChangeListener callback,
                 int priority)

Add callback as a new listener for what

Parameters:

what - The object that is to be monitored

callback - The object receiving notification

priority - The priority - smaller numbers lead to earlier calls.

removeListener

void removeListener(Object what,
                    ChangeListener callback)

Remove a callback from the listener list for object what

Parameters:

what - The monitored object

callback - The PropertyChangeListener to be removed

firePropertyChange

void firePropertyChange(Object procElement,
                        Object property)

Notify all interested parties of changes to a Process element

Parameters:

procElement - The altered Process element

property - The altered property

firePropertyChange

void firePropertyChange(Object procElement,
                        Object property,
                        Object newValue)

Notify all interested parties of changes to a Process element

Parameters:

procElement - The altered Process element

property - The altered property

newValue - The new value of the process element

firePropertyChange

void firePropertyChange(Object procElement,
                        Object property,
                        Object oldValue,
                        Object newValue)

Notify all interested parties of changes to a Process element

Parameters:

procElement - The altered Process element

property - The altered property

oldValue - The old value of the process element

newValue - The new value of the process element

sendPropertyChanges

void sendPropertyChanges()

Send all queued events and flush the queue.