com.jgoodies.common.bean

Interface ObservableBean2

public interface ObservableBean2 extends ObservableBean

In addition to its super interface ObservableBean, this interface describes the optional support for registering PropertyChangeListeners for an individual property name. This interface is primarily intended to ensure compile-time safety for beans that shall be observed.

Version: $Revision: 1.2 $

Author: Karsten Lentzsch

See Also: PropertyChangeListener java.beans.PropertyChangeEvent java.beans.PropertyChangeSupport

Method Summary
voidaddPropertyChangeListener(String propertyName, PropertyChangeListener listener)
Adds a PropertyChangeListener to the listener list for a specific property.
PropertyChangeListener[]getPropertyChangeListeners()
Returns an array of all the property change listeners registered on this component.
PropertyChangeListener[]getPropertyChangeListeners(String propertyName)
Returns an array of all the listeners which have been associated with the named property.
voidremovePropertyChangeListener(String propertyName, PropertyChangeListener listener)
Removes a PropertyChangeListener from the listener list for a specific property.

Method Detail

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
Adds a PropertyChangeListener to the listener list for a specific property. The specified property may be user-defined.

Note that if this bean is inheriting a bound property, then no event will be fired in response to a change in the inherited property.

If listener is null, no exception is thrown and no action is performed.

Parameters: propertyName one of the property names listed above listener the PropertyChangeListener to be added

See Also: ObservableBean2 ObservableBean2 ObservableBean2 getPropertyChangeListeners

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()
Returns an array of all the property change listeners registered on this component.

Returns: all of this component's {@code PropertyChangeListener}s or an empty array if no property change listeners are currently registered

See Also: ObservableBean2 ObservableBean2 getPropertyChangeListeners java.beans.PropertyChangeSupport#getPropertyChangeListeners()

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
Returns an array of all the listeners which have been associated with the named property.

Parameters: propertyName the name of the property to lookup listeners

Returns: all of the {@code PropertyChangeListeners} associated with the named property or an empty array if no listeners have been added

See Also: ObservableBean2 ObservableBean2 getPropertyChangeListeners

removePropertyChangeListener

public void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)
Removes a PropertyChangeListener from the listener list for a specific property. This method should be used to remove PropertyChangeListeners that were registered for a specific bound property.

If listener is null, no exception is thrown and no action is performed.

Parameters: propertyName a valid property name listener the PropertyChangeListener to be removed

See Also: ObservableBean2 ObservableBean2 ObservableBean2 getPropertyChangeListeners

Copyright © 2009-2010 JGoodies Karsten Lentzsch. All Rights Reserved.