com.jgoodies.common.bean
Interface ObservableBean2

All Superinterfaces:

ObservableBean

All Known Subinterfaces:

IActionBean

All Known Implementing Classes:

Bean

public interface ObservableBean2
extends ObservableBean

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

Version:

$Revision: 1.3 $

Author:

Karsten Lentzsch

See Also:

PropertyChangeListener, PropertyChangeEvent, PropertyChangeSupport

Method Summary

void	addPropertyChangeListener(String propertyName, PropertyChangeListener listener) Adds a PropertyChangeListener to the listener list for a specifi property.
PropertyChangeListener[]	getPropertyChangeListeners() Returns an array of all the property change listener registered on this component.
PropertyChangeListener[]	getPropertyChangeListeners(String propertyName) Returns an array of all the listeners which have been associate with the named property.
void	removePropertyChangeListener(String propertyName, PropertyChangeListener listener) Removes a PropertyChangeListener from the listener list for a specifi property.

Methods inherited from interface com.jgoodies.common.bean.ObservableBean

addPropertyChangeListener, removePropertyChangeListener

Method Detail

addPropertyChangeListener

void addPropertyChangeListener(String propertyName,
                               PropertyChangeListener listener)

Adds a PropertyChangeListener to the listener list for a specifi property. The specified property may be user-defined.

Parameters:

propertyName - one of the property names listed above

listener - the PropertyChangeListener to be added

See Also:

ObservableBean.removePropertyChangeListener(PropertyChangeListener), removePropertyChangeListener(String, PropertyChangeListener), ObservableBean.addPropertyChangeListener(PropertyChangeListener), getPropertyChangeListeners(String)

removePropertyChangeListener

void removePropertyChangeListener(String propertyName,
                                  PropertyChangeListener listener)

Removes a PropertyChangeListener from the listener list for a specifi property. This method should be used to remove PropertyChangeListener that were registered for a specific bound property.

Parameters:

propertyName - a valid property name

listener - the PropertyChangeListener to be removed

See Also:

ObservableBean.addPropertyChangeListener(PropertyChangeListener), addPropertyChangeListener(String, PropertyChangeListener), ObservableBean.removePropertyChangeListener(PropertyChangeListener), getPropertyChangeListeners(String)

getPropertyChangeListeners

PropertyChangeListener[] getPropertyChangeListeners()

Returns an array of all the property change listener registered on this component.

Returns:

all of this component's PropertyChangeListener or an empty array if no property chang listeners are currently registered

See Also:

ObservableBean.addPropertyChangeListener(PropertyChangeListener), ObservableBean.removePropertyChangeListener(PropertyChangeListener), getPropertyChangeListeners(String), PropertyChangeSupport.getPropertyChangeListeners()

getPropertyChangeListeners

PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

Returns an array of all the listeners which have been associate with the named property.

Parameters:

propertyName - the name of the property to lookup listeners

Returns:

all of the PropertyChangeListeners associated wit the named property or an empty array if no listeners hav been added

See Also:

addPropertyChangeListener(String, PropertyChangeListener), removePropertyChangeListener(String, PropertyChangeListener), getPropertyChangeListeners()