org.beanfabrics.event
Class BnPropertyChangeSupport

java.lang.Object
  extended by org.beanfabrics.event.BnPropertyChangeSupport

public class BnPropertyChangeSupport
extends java.lang.Object

This is a utility class that can be used by beans that support bound properties.

Author:
Michael Karneim

Constructor Summary
BnPropertyChangeSupport(java.lang.Object sourceBean)
          Constructs a PropertyChangeSupport.
 
Method Summary
 void addPropertyChangeListener(java.beans.PropertyChangeListener listener)
          Add a PropertyChangeListener to the listener listCell.
 void addPropertyChangeListener(java.lang.String propertyName, java.beans.PropertyChangeListener listener)
          Add a PropertyChangeListener for a specific property.
 void firePropertyChange(BnPropertyChangeEvent evt)
          Fire an existing PropertyChangeEvent to any registered listeners.
 void firePropertyChange(java.lang.String propertyName, java.lang.Object oldValue, java.lang.Object newValue)
           
 void firePropertyChange(java.lang.String propertyName, java.lang.Object oldValue, java.lang.Object newValue, java.util.EventObject cause)
          Report a bound property update to any registered listeners.
 boolean hasListeners()
           
 boolean hasListeners(java.lang.String propertyName)
          Check if there are any listeners for a specific property.
 void removePropertyChangeListener(java.beans.PropertyChangeListener listener)
          Remove a PropertyChangeListener from the listener listCell.
 void removePropertyChangeListener(java.lang.String propertyName, java.beans.PropertyChangeListener listener)
          Remove a PropertyChangeListener for a specific property.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

BnPropertyChangeSupport

public BnPropertyChangeSupport(java.lang.Object sourceBean)
Constructs a PropertyChangeSupport.

Parameters:
sourceBean - The bean to be given as the source for any events
Method Detail

addPropertyChangeListener

public void addPropertyChangeListener(java.beans.PropertyChangeListener listener)
Add a PropertyChangeListener to the listener listCell. The listener is registered for all properties.

Parameters:
listener - the PropertyChangeListener to be added

removePropertyChangeListener

public void removePropertyChangeListener(java.beans.PropertyChangeListener listener)
Remove a PropertyChangeListener from the listener listCell. This removes a PropertyChangeListener that was registered for all properties.

Parameters:
listener - the PropertyChangeListener to be removed

addPropertyChangeListener

public void addPropertyChangeListener(java.lang.String propertyName,
                                      java.beans.PropertyChangeListener listener)
Add a PropertyChangeListener for a specific property. The listener will be invoked only when a call on firePropertyChange names that specific property.

Parameters:
propertyName - the name of the property to listen on
listener - the PropertyChangeListener to be added

removePropertyChangeListener

public void removePropertyChangeListener(java.lang.String propertyName,
                                         java.beans.PropertyChangeListener listener)
Remove a PropertyChangeListener for a specific property.

Parameters:
propertyName - the name of the property that was listened on
listener - the PropertyChangeListener to be removed

firePropertyChange

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

firePropertyChange

public void firePropertyChange(java.lang.String propertyName,
                               java.lang.Object oldValue,
                               java.lang.Object newValue,
                               java.util.EventObject cause)
Report a bound property update to any registered listeners. No event is fired if old and new are equal and non-null.

Parameters:
propertyName - the programmatic name of the property that was changed
oldValue - the old value of the property
newValue - the new value of the property
cause - the event that caused the event

firePropertyChange

public void firePropertyChange(BnPropertyChangeEvent evt)
Fire an existing PropertyChangeEvent to any registered listeners. No event is fired if the given event's old and new values are equal and non-null.

Parameters:
evt - the PropertyChangeEvent object

hasListeners

public boolean hasListeners(java.lang.String propertyName)
Check if there are any listeners for a specific property.

Parameters:
propertyName - the property name
Returns:
true if there are ore or more listeners for the given property

hasListeners

public boolean hasListeners()


© 2010 by Michael Karneim, http://www.beanfabrics.org