BeanContextChild
, BeanContextServiceRevokedListener
, BeanContextServicesListener
, Serializable
, EventListener
BeanContextSupport
public class BeanContextChildSupport extends Object implements BeanContextChild, BeanContextServicesListener, Serializable
This is a general support class to provide support for implementing the BeanContextChild protocol. This class may either be directly subclassed, or encapsulated and delegated to in order to implement this interface for a given component.
Modifier and Type | Field | Description |
---|---|---|
protected BeanContext |
beanContext |
The bean context. |
BeanContextChild |
beanContextChildPeer |
The BeanContext in which this BeanContextChild is nested. |
protected PropertyChangeSupport |
pcSupport |
The PropertyChangeSupport associated with this BeanContextChildSupport . |
protected boolean |
rejectedSetBCOnce |
A flag indicating that there has been at least one PropertyChangeVetoException thrown for the attempted setBeanContext operation. |
protected VetoableChangeSupport |
vcSupport |
The VetoableChangeSupport associated with this BeanContextChildSupport . |
Constructor | Description |
---|---|
BeanContextChildSupport() |
construct a BeanContextChildSupport where this class has been subclassed in order to implement the JavaBean component itself. |
BeanContextChildSupport |
construct a BeanContextChildSupport where the JavaBean component itself implements BeanContextChild, and encapsulates this, delegating that interface to this implementation |
Modifier and Type | Method | Description |
---|---|---|
void |
addPropertyChangeListener |
Add a PropertyChangeListener for a specific property. |
void |
addVetoableChangeListener |
Add a VetoableChangeListener for a specific property. |
void |
firePropertyChange |
Report a bound property update to any registered listeners. |
void |
fireVetoableChange |
Report a vetoable property update to any registered listeners. |
BeanContext |
getBeanContext() |
Gets the nesting BeanContext for this BeanContextChildSupport . |
BeanContextChild |
getBeanContextChildPeer() |
Gets the BeanContextChild associated with this BeanContextChildSupport . |
protected void |
initializeBeanContextResources() |
This method may be overridden by subclasses to provide their own initialization behaviors. |
boolean |
isDelegated() |
Reports whether or not this class is a delegate of another. |
protected void |
releaseBeanContextResources() |
This method may be overridden by subclasses to provide their own release behaviors. |
void |
removePropertyChangeListener |
Remove a PropertyChangeListener for a specific property. |
void |
removeVetoableChangeListener |
Removes a VetoableChangeListener . |
void |
serviceAvailable |
A new service is available from the nesting BeanContext. |
void |
serviceRevoked |
A service provided by the nesting BeanContext has been revoked. |
void |
setBeanContext |
Sets the BeanContext for this BeanContextChildSupport . |
boolean |
validatePendingSetBeanContext |
Called from setBeanContext to validate (or otherwise) the pending change in the nesting BeanContext property value. |
public BeanContextChild beanContextChildPeer
BeanContext
in which this BeanContextChild
is nested.protected PropertyChangeSupport pcSupport
PropertyChangeSupport
associated with this BeanContextChildSupport
.protected VetoableChangeSupport vcSupport
VetoableChangeSupport
associated with this BeanContextChildSupport
.protected transient BeanContext beanContext
protected transient boolean rejectedSetBCOnce
PropertyChangeVetoException
thrown for the attempted setBeanContext operation.public BeanContextChildSupport()
public BeanContextChildSupport(BeanContextChild bcc)
bcc
- the underlying bean context childpublic void setBeanContext(BeanContext bc) throws PropertyVetoException
BeanContext
for this BeanContextChildSupport
.setBeanContext
in interface BeanContextChild
bc
- the new value to be assigned to the BeanContext
propertyPropertyVetoException
- if the change is rejectedpublic BeanContext getBeanContext()
BeanContext
for this BeanContextChildSupport
.getBeanContext
in interface BeanContextChild
BeanContext
for this BeanContextChildSupport
.public void addPropertyChangeListener(String name, PropertyChangeListener pcl)
name
or pcl
is null, no exception is thrown and no action is taken.addPropertyChangeListener
in interface BeanContextChild
name
- The name of the property to listen onpcl
- The PropertyChangeListener
to be addedpublic void removePropertyChangeListener(String name, PropertyChangeListener pcl)
pcl
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 name
is null, no exception is thrown and no action is taken. If pcl
is null, or was never added for the specified property, no exception is thrown and no action is taken.removePropertyChangeListener
in interface BeanContextChild
name
- The name of the property that was listened onpcl
- The PropertyChangeListener to be removedpublic void addVetoableChangeListener(String name, VetoableChangeListener vcl)
name
or vcl
is null, no exception is thrown and no action is taken.addVetoableChangeListener
in interface BeanContextChild
name
- The name of the property to listen onvcl
- The VetoableChangeListener
to be addedpublic void removeVetoableChangeListener(String name, VetoableChangeListener vcl)
VetoableChangeListener
. If pcl
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 name
is null, no exception is thrown and no action is taken. If vcl
is null, or was never added for the specified property, no exception is thrown and no action is taken.removeVetoableChangeListener
in interface BeanContextChild
name
- The name of the property that was listened onvcl
- The VetoableChangeListener
to be removedpublic void serviceRevoked(BeanContextServiceRevokedEvent bcsre)
serviceRevoked
in interface BeanContextServiceRevokedListener
bcsre
- The BeanContextServiceRevokedEvent
fired as a result of a service being revokedpublic void serviceAvailable(BeanContextServiceAvailableEvent bcsae)
serviceAvailable
in interface BeanContextServicesListener
bcsae
- The BeanContextServiceAvailableEvent fired as a result of a service becoming availablepublic BeanContextChild getBeanContextChildPeer()
BeanContextChild
associated with this BeanContextChildSupport
.BeanContextChild
peer of this classpublic boolean isDelegated()
public void firePropertyChange(String name, Object oldValue, Object newValue)
name
- The programmatic name of the property that was changedoldValue
- The old value of the propertynewValue
- The new value of the propertypublic void fireVetoableChange(String name, Object oldValue, Object newValue) throws PropertyVetoException
No event is fired if old and new are equal and non-null.
name
- The programmatic name of the property that is about to changeoldValue
- The old value of the propertynewValue
- - The new value of the propertyPropertyVetoException
- if the recipient wishes the property change to be rolled back.public boolean validatePendingSetBeanContext(BeanContext newValue)
newValue
- the new value that has been requested for the BeanContext propertytrue
if the change operation is to be vetoedprotected void releaseBeanContextResources()
protected void initializeBeanContextResources()
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/java/beans/beancontext/BeanContextChildSupport.html