BeanContext
, BeanContextServices
BeanContextChildSupport
, BeanContextServicesSupport
, BeanContextSupport
public interface BeanContextChild
JavaBeans wishing to be nested within, and obtain a reference to their execution environment, or context, as defined by the BeanContext sub-interface shall implement this interface.
Conformant BeanContexts shall as a side effect of adding a BeanContextChild object shall pass a reference to itself via the setBeanContext() method of this interface.
Note that a BeanContextChild may refuse a change in state by throwing PropertyVetoedException in response.
In order for persistence mechanisms to function properly on BeanContextChild instances across a broad variety of scenarios, implementing classes of this interface are required to define as transient, any or all fields, or instance variables, that may contain, or represent, references to the nesting BeanContext instance or other resources obtained from the BeanContext via any unspecified mechanisms.
Modifier and Type | Method | Description |
---|---|---|
void |
addPropertyChangeListener |
Adds a PropertyChangeListener to this BeanContextChild in order to receive a PropertyChangeEvent whenever the specified property has changed. |
void |
addVetoableChangeListener |
Adds a VetoableChangeListener to this BeanContextChild to receive events whenever the specified property changes. |
BeanContext |
getBeanContext() |
Gets the BeanContext associated with this BeanContextChild . |
void |
removePropertyChangeListener |
Removes a PropertyChangeListener from this BeanContextChild so that it no longer receives PropertyChangeEvents when the specified property is changed. |
void |
removeVetoableChangeListener |
Removes a VetoableChangeListener from this BeanContextChild so that it no longer receives events when the specified property changes. |
void |
setBeanContext |
Objects that implement this interface, shall fire a java.beans.PropertyChangeEvent, with parameters: propertyName "beanContext", oldValue (the previous nesting BeanContext instance, or null ), newValue (the current nesting BeanContext instance, or null ). |
void setBeanContext(BeanContext bc) throws PropertyVetoException
Objects that implement this interface, shall fire a java.beans.PropertyChangeEvent, with parameters: propertyName "beanContext", oldValue (the previous nesting BeanContext
instance, or null
), newValue (the current nesting BeanContext
instance, or null
).
A change in the value of the nesting BeanContext property of this BeanContextChild may be vetoed by throwing the appropriate exception.
bc
- The BeanContext
with which to associate this BeanContextChild
.PropertyVetoException
- if the addition of the specified BeanContext
is refused.BeanContext getBeanContext()
BeanContext
associated with this BeanContextChild
.BeanContext
associated with this BeanContextChild
.void addPropertyChangeListener(String name, PropertyChangeListener pcl)
PropertyChangeListener
to this BeanContextChild
in order to receive a PropertyChangeEvent
whenever the specified property has changed.name
- the name of the property to listen onpcl
- the PropertyChangeListener
to addvoid removePropertyChangeListener(String name, PropertyChangeListener pcl)
PropertyChangeListener
from this BeanContextChild
so that it no longer receives PropertyChangeEvents
when the specified property is changed.name
- the name of the property that was listened onpcl
- the PropertyChangeListener
to removevoid addVetoableChangeListener(String name, VetoableChangeListener vcl)
VetoableChangeListener
to this BeanContextChild
to receive events whenever the specified property changes.name
- the name of the property to listen onvcl
- the VetoableChangeListener
to addvoid removeVetoableChangeListener(String name, VetoableChangeListener vcl)
VetoableChangeListener
from this BeanContextChild
so that it no longer receives events when the specified property changes.name
- the name of the property that was listened on.vcl
- the VetoableChangeListener
to remove.
© 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/BeanContextChild.html