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.
BeanContext,
BeanContextServices,
BeanContextChild,
Serialized Form| Modifier and Type | Field and 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 and Description |
|---|
BeanContextChildSupport()
construct a BeanContextChildSupport where this class has been
subclassed in order to implement the JavaBean component itself.
|
BeanContextChildSupport(BeanContextChild bcc)
construct a BeanContextChildSupport where the JavaBean component
itself implements BeanContextChild, and encapsulates this, delegating
that interface to this implementation
|
| Modifier and Type | Method and Description |
|---|---|
void |
addPropertyChangeListener(String name,
PropertyChangeListener pcl)
Add a PropertyChangeListener for a specific property.
|
void |
addVetoableChangeListener(String name,
VetoableChangeListener vcl)
Add a VetoableChangeListener for a specific property.
|
void |
firePropertyChange(String name,
Object oldValue,
Object newValue)
Report a bound property update to any registered listeners.
|
void |
fireVetoableChange(String name,
Object oldValue,
Object newValue)
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(String name,
PropertyChangeListener pcl)
Remove a PropertyChangeListener for a specific property.
|
void |
removeVetoableChangeListener(String name,
VetoableChangeListener vcl)
Removes a
VetoableChangeListener. |
void |
serviceAvailable(BeanContextServiceAvailableEvent bcsae)
A new service is available from the nesting BeanContext.
|
void |
serviceRevoked(BeanContextServiceRevokedEvent bcsre)
A service provided by the nesting BeanContext has been revoked.
|
void |
setBeanContext(BeanContext bc)
Sets the
BeanContext for
this BeanContextChildSupport. |
boolean |
validatePendingSetBeanContext(BeanContext newValue)
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
protected VetoableChangeSupport vcSupport
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 BeanContextChildbc - the new value to be assigned to the BeanContext
propertyPropertyVetoException - if the change is rejectedpublic BeanContext getBeanContext()
BeanContext
for this BeanContextChildSupport.getBeanContext in interface BeanContextChildBeanContext 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 BeanContextChildname - 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 BeanContextChildname - 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 BeanContextChildname - 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 BeanContextChildname - The name of the property that was listened onvcl - The VetoableChangeListener to be removedpublic void serviceRevoked(BeanContextServiceRevokedEvent bcsre)
serviceRevoked in interface BeanContextServiceRevokedListenerbcsre - The BeanContextServiceRevokedEvent fired as a
result of a service being revokedpublic void serviceAvailable(BeanContextServiceAvailableEvent bcsae)
serviceAvailable in interface BeanContextServicesListenerbcsae - The BeanContextServiceAvailableEvent fired as a
result of a service becoming availablepublic BeanContextChild getBeanContextChildPeer()
public 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()
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2020, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.