java.beans

Class PropertyChangeListenerProxy

java.lang.Object

java.util.EventListenerProxy

java.beans.PropertyChangeListenerProxy

All Implemented Interfaces:

PropertyChangeListener, EventListener

public class PropertyChangeListenerProxy
extends EventListenerProxy
implements PropertyChangeListener

This class provides an extension to PropertyChangeListener - associating a name with the listener. This can be used to filter the changes that one is interested in.

Since:

1.4

Constructor Summary

Constructors

Constructor and Description
PropertyChangeListenerProxy(String propertyName, PropertyChangeListener listener) Create a new proxy which filters property change events and only passes changes to the named property on to the delegate.

Method Summary

Methods

Modifier and Type	Method and Description
String	getPropertyName() Gets the name of the property this proxy is filtering on.
void	propertyChange(PropertyChangeEvent event) Forwards the event on to the delegate if the property name matches.

Methods inherited from class java.util.EventListenerProxy

getListener

Methods inherited from class java.lang.Object

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

Constructor Detail

PropertyChangeListenerProxy

public PropertyChangeListenerProxy(String propertyName,
                           PropertyChangeListener listener)

Create a new proxy which filters property change events and only passes changes to the named property on to the delegate. A null propertyName or listener does not fail now, but may cause a NullPointerException down the road.

Parameters:

propertyName - the property's name to filter on

listener - the delegate listener

Method Detail

propertyChange

public void propertyChange(PropertyChangeEvent event)

Forwards the event on to the delegate if the property name matches.

Specified by:

propertyChange in interface PropertyChangeListener

Parameters:

event - the event to pass on, if it meets the filter

Throws:

NullPointerException - if the delegate this was created with is null

getPropertyName

public String getPropertyName()

Gets the name of the property this proxy is filtering on.

Returns:

the property name