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.
BeanContext
,
BeanContextServices
,
BeanContextChild
,
Serialized FormModifier 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(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 | 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
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()
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, 2017, Oracle and/or its affiliates. 500 Oracle Parkway
Redwood Shores, CA 94065 USA. All rights reserved.
DRAFT 9-internal+0-adhoc.mlchung.jdk9-jdeps