celeboss.data
Class PropertyEventManager

java.lang.Object
  celeboss.data.PropertyEventManager

public class PropertyEventManager

extends java.lang.Object

This class managers the distribution of PropertyChangeEvents to a number of PropertyChangeListeners. It differs from teh standard PropertyChnage Support class in the fact that events can be queued or delayed. This would generalyl be done when a mass update is being performed where multiple events of the same operation would be generated.

Version:

1.0

Author:

bevans

Constructor Summary

PropertyEventManager(java.lang.Object source)
Create a managers that represents a single source.

Method Summary

void	addPropertyChangeListener(java.beans.PropertyChangeListener newListener) Add a listeners for all properties.
void	addPropertyChangeListener(java.lang.String propertyName, java.beans.PropertyChangeListener listener) Add a property listeners to a specific property name
void	firePropertyChange(java.lang.String prop, java.lang.Object oldValue, java.lang.Object newValue) Fire the change to the listeners.
void	removePropertyChangeListener(java.beans.PropertyChangeListener oldListener) Remove a previously register get all listener.
void	removePropertyChangeListener(java.lang.String propertyName, java.beans.PropertyChangeListener listener) Remote a previously registered listener.
void	setSuspended(boolean suspend) Change the suspended state of this distributor.

Methods inherited from class java.lang.Object

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

Constructor Detail

PropertyEventManager

public PropertyEventManager(java.lang.Object source)

Create a managers that represents a single source.

Parameters:

source - Source to represent.

Method Detail

addPropertyChangeListener

public void addPropertyChangeListener(java.beans.PropertyChangeListener newListener)

Add a listeners for all properties.

Parameters:

newListener - The listener to add.

addPropertyChangeListener

public void addPropertyChangeListener(java.lang.String propertyName,
                                      java.beans.PropertyChangeListener listener)

Add a property listeners to a specific property name

Parameters:

propertyName - Name to listen

listener - Listener wanting notification

firePropertyChange

public void firePropertyChange(java.lang.String prop,
                               java.lang.Object oldValue,
                               java.lang.Object newValue)

Fire the change to the listeners. This may be queued if the notification is suspended.

Parameters:

prop - Property name

oldValue - Old value.

newValue - New Value.

removePropertyChangeListener

public void removePropertyChangeListener(java.lang.String propertyName,
                                         java.beans.PropertyChangeListener listener)

Remote a previously registered listener.

Parameters:

propertyName - Watched property

listener - Receiver of notification

removePropertyChangeListener

public void removePropertyChangeListener(java.beans.PropertyChangeListener oldListener)

Remove a previously register get all listener.

Parameters:

oldListener - Listener to remove

setSuspended

public void setSuspended(boolean suspend)

Change the suspended state of this distributor. If it is suspended then all events are queued.

Parameters:

suspend - New suspend state.