|
Java™ Platform Standard Ed. 6 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectjava.beans.beancontext.BeanContextChildSupport
public class BeanContextChildSupport
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| Field Summary | |
|---|---|
protected BeanContext |
beanContext
|
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 Summary | |
|---|---|
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 |
|
| Method Summary | |
|---|---|
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. |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
|---|
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.
| Constructor Detail |
|---|
public BeanContextChildSupport()
public BeanContextChildSupport(BeanContextChild bcc)
| Method Detail |
|---|
public void setBeanContext(BeanContext bc)
throws PropertyVetoException
BeanContext for
this BeanContextChildSupport.
setBeanContext in interface BeanContextChildbc - the new value to be assigned to the BeanContext
property
PropertyVetoException - if the change is rejected
PropertyVetoExceptionpublic 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 added
public 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 removed
public 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 added
public 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 property
public 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 property
PropertyVetoException - 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 property
true if the change operation is to be vetoedprotected void releaseBeanContextResources()
protected void initializeBeanContextResources()
|
Java™ Platform Standard Ed. 6 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright © 1993, 2010, Oracle and/or its affiliates. All rights reserved.