java.lang.Object | |
↳ | java.beans.VetoableChangeSupport |
This is a utility class that can be used by beans that support constrained properties. You can use an instance of this class as a member field of your bean and delegate various work to it. This class is serializable. When it is serialized it will save (and restore) any listeners that are themselves serializable. Any non-serializable listeners will be skipped during serialization.
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructs a
VetoableChangeSupport object. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Add a VetoableChangeListener to the listener list.
| |||||||||||
Add a VetoableChangeListener for a specific property.
| |||||||||||
Report a boolean vetoable property update to any registered listeners.
| |||||||||||
Fire a vetoable property update to any registered listeners.
| |||||||||||
Report a vetoable property update to any registered listeners.
| |||||||||||
Report a int vetoable property update to any registered listeners.
| |||||||||||
Returns the list of VetoableChangeListeners.
| |||||||||||
Returns an array of all the listeners which have been associated
with the named property.
| |||||||||||
Check if there are any listeners for a specific property, including
those registered on all properties.
| |||||||||||
Remove a VetoableChangeListener for a specific property.
| |||||||||||
Remove a VetoableChangeListener from the listener list.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Constructs a VetoableChangeSupport
object.
sourceBean | The bean to be given as the source for any events. |
---|
Add a VetoableChangeListener to the listener list.
The listener is registered for all properties.
The same listener object may be added more than once, and will be called
as many times as it is added.
If listener
is null, no exception is thrown and no action
is taken.
listener | The VetoableChangeListener to be added |
---|
Add a VetoableChangeListener for a specific property. The listener
will be invoked only when a call on fireVetoableChange names that
specific property.
The same listener object may be added more than once. For each
property, the listener will be invoked the number of times it was added
for that property.
If propertyName
or listener
is null, no
exception is thrown and no action is taken.
propertyName | The name of the property to listen on. |
---|---|
listener | The VetoableChangeListener to be added |
Report a boolean vetoable property update to any registered listeners. No event is fired if old and new are equal.
This is merely a convenience wrapper around the more general fireVetoableChange method that takes Object values.
propertyName | The programmatic name of the property that is about to change. |
---|---|
oldValue | The old value of the property. |
newValue | The new value of the property. |
PropertyVetoException |
---|
Fire a vetoable property update to any registered listeners. If anyone vetos the change, then fire a new event reverting everyone to the old value and then rethrow the PropertyVetoException.
No event is fired if old and new are equal and non-null.
evt | The PropertyChangeEvent to be fired. |
---|
PropertyVetoException | if the recipient wishes the property change to be rolled back. |
---|
Report a vetoable property update to any registered listeners. If anyone vetos the change, then fire a new event reverting everyone to the old value and then rethrow the PropertyVetoException.
No event is fired if old and new are equal and non-null.
propertyName | The programmatic name of the property that is about to change.. |
---|---|
oldValue | The old value of the property. |
newValue | The new value of the property. |
PropertyVetoException | if the recipient wishes the property change to be rolled back. |
---|
Report a int vetoable property update to any registered listeners. No event is fired if old and new are equal.
This is merely a convenience wrapper around the more general fireVetoableChange method that takes Object values.
propertyName | The programmatic name of the property that is about to change. |
---|---|
oldValue | The old value of the property. |
newValue | The new value of the property. |
PropertyVetoException |
---|
Returns the list of VetoableChangeListeners. If named vetoable change listeners were added, then VetoableChangeListenerProxy wrappers will returned
Returns an array of all the listeners which have been associated with the named property.
propertyName | The name of the property being listened to |
---|
VetoableChangeListeners
associated with
the named property. If no such listeners have been added,
or if propertyName
is null, an empty array is
returned.Check if there are any listeners for a specific property, including
those registered on all properties. If propertyName
is null, only check for listeners registered on all properties.
propertyName | the property name. |
---|
Remove a VetoableChangeListener for a specific property.
If listener
was added more than once to the same event
source for the specified property, it will be notified one less time
after being removed.
If propertyName
is null, no exception is thrown and no
action is taken.
If listener
is null, or was never added for the specified
property, no exception is thrown and no action is taken.
propertyName | The name of the property that was listened on. |
---|---|
listener | The VetoableChangeListener to be removed |
Remove a VetoableChangeListener from the listener list.
This removes a VetoableChangeListener that was registered
for all properties.
If listener
was added more than once to the same event
source, it will be notified one less time after being removed.
If listener
is null, or was never added, no exception is
thrown and no action is taken.
listener | The VetoableChangeListener to be removed |
---|