|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.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 FormField 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 BeanContextChild
bc
- the new value to be assigned to the BeanContext
property
PropertyVetoException
- if the change is rejected
PropertyVetoException
public 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()
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 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, 2011, Oracle and/or its affiliates. All rights reserved.