Class BeanContextChildSupport
java.lang.Object
java.beans.beancontext.BeanContextChildSupport
- All Implemented Interfaces:
- BeanContextChild,- BeanContextServiceRevokedListener,- BeanContextServicesListener,- Serializable,- EventListener
- Direct Known Subclasses:
- BeanContextSupport
@Deprecated(since="23",
            forRemoval=true)
public class BeanContextChildSupport
extends Object
implements BeanContextChild, BeanContextServicesListener, Serializable
Deprecated, for removal: This API element is subject to removal in a future version.
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.
- Since:
- 1.2
- See Also:
- 
Field SummaryFieldsModifier and TypeFieldDescriptionprotected BeanContextDeprecated, for removal: This API element is subject to removal in a future version.The bean context.Deprecated, for removal: This API element is subject to removal in a future version.TheBeanContextin which thisBeanContextChildis nested.protected PropertyChangeSupportDeprecated, for removal: This API element is subject to removal in a future version.ThePropertyChangeSupportassociated with thisBeanContextChildSupport.protected booleanDeprecated, for removal: This API element is subject to removal in a future version.A flag indicating that there has been at least onePropertyChangeVetoExceptionthrown for the attempted setBeanContext operation.protected VetoableChangeSupportDeprecated, for removal: This API element is subject to removal in a future version.TheVetoableChangeSupportassociated with thisBeanContextChildSupport.
- 
Constructor SummaryConstructorsConstructorDescriptionDeprecated, for removal: This API element is subject to removal in a future version.construct a BeanContextChildSupport where this class has been subclassed in order to implement the JavaBean component itself.Deprecated, for removal: This API element is subject to removal in a future version.construct a BeanContextChildSupport where the JavaBean component itself implements BeanContextChild, and encapsulates this, delegating that interface to this implementation
- 
Method SummaryModifier and TypeMethodDescriptionvoidDeprecated, for removal: This API element is subject to removal in a future version.Add a PropertyChangeListener for a specific property.voidDeprecated, for removal: This API element is subject to removal in a future version.Add a VetoableChangeListener for a specific property.voidfirePropertyChange(String name, Object oldValue, Object newValue) Deprecated, for removal: This API element is subject to removal in a future version.Report a bound property update to any registered listeners.voidfireVetoableChange(String name, Object oldValue, Object newValue) Deprecated, for removal: This API element is subject to removal in a future version.Report a vetoable property update to any registered listeners.Deprecated, for removal: This API element is subject to removal in a future version.Gets the nestingBeanContextfor thisBeanContextChildSupport.Deprecated, for removal: This API element is subject to removal in a future version.Gets theBeanContextChildassociated with thisBeanContextChildSupport.protected voidDeprecated, for removal: This API element is subject to removal in a future version.This method may be overridden by subclasses to provide their own initialization behaviors.booleanDeprecated, for removal: This API element is subject to removal in a future version.Reports whether or not this class is a delegate of another.protected voidDeprecated, for removal: This API element is subject to removal in a future version.This method may be overridden by subclasses to provide their own release behaviors.voidDeprecated, for removal: This API element is subject to removal in a future version.Remove a PropertyChangeListener for a specific property.voidDeprecated, for removal: This API element is subject to removal in a future version.Removes aVetoableChangeListener.voidDeprecated, for removal: This API element is subject to removal in a future version.A new service is available from the nesting BeanContext.voidDeprecated, for removal: This API element is subject to removal in a future version.A service provided by the nesting BeanContext has been revoked.voidDeprecated, for removal: This API element is subject to removal in a future version.Sets theBeanContextfor thisBeanContextChildSupport.booleanvalidatePendingSetBeanContext(BeanContext newValue) Deprecated, for removal: This API element is subject to removal in a future version.Called from setBeanContext to validate (or otherwise) the pending change in the nesting BeanContext property value.
- 
Field Details- 
beanContextChildPeerDeprecated, for removal: This API element is subject to removal in a future version.TheBeanContextin which thisBeanContextChildis nested.
- 
pcSupportDeprecated, for removal: This API element is subject to removal in a future version.ThePropertyChangeSupportassociated with thisBeanContextChildSupport.
- 
vcSupportDeprecated, for removal: This API element is subject to removal in a future version.TheVetoableChangeSupportassociated with thisBeanContextChildSupport.
- 
beanContextDeprecated, for removal: This API element is subject to removal in a future version.The bean context.
- 
rejectedSetBCOnceprotected transient boolean rejectedSetBCOnceDeprecated, for removal: This API element is subject to removal in a future version.A flag indicating that there has been at least onePropertyChangeVetoExceptionthrown for the attempted setBeanContext operation.
 
- 
- 
Constructor Details- 
BeanContextChildSupportpublic BeanContextChildSupport()Deprecated, for removal: This API element is subject to removal in a future version.construct a BeanContextChildSupport where this class has been subclassed in order to implement the JavaBean component itself.
- 
BeanContextChildSupportDeprecated, for removal: This API element is subject to removal in a future version.construct a BeanContextChildSupport where the JavaBean component itself implements BeanContextChild, and encapsulates this, delegating that interface to this implementation- Parameters:
- bcc- the underlying bean context child
 
 
- 
- 
Method Details- 
setBeanContextDeprecated, for removal: This API element is subject to removal in a future version.Sets theBeanContextfor thisBeanContextChildSupport.- Specified by:
- setBeanContextin interface- BeanContextChild
- Parameters:
- bc- the new value to be assigned to the- BeanContextproperty
- Throws:
- PropertyVetoException- if the change is rejected
 
- 
getBeanContextDeprecated, for removal: This API element is subject to removal in a future version.Gets the nestingBeanContextfor thisBeanContextChildSupport.- Specified by:
- getBeanContextin interface- BeanContextChild
- Returns:
- the nesting BeanContextfor thisBeanContextChildSupport.
 
- 
addPropertyChangeListenerDeprecated, for removal: This API element is subject to removal in a future version.Add a PropertyChangeListener for a specific property. The same listener object may be added more than once. For each property, the listener will be invoked the number of times it was added for that property. Ifnameorpclis null, no exception is thrown and no action is taken.- Specified by:
- addPropertyChangeListenerin interface- BeanContextChild
- Parameters:
- name- The name of the property to listen on
- pcl- The- PropertyChangeListenerto be added
 
- 
removePropertyChangeListenerDeprecated, for removal: This API element is subject to removal in a future version.Remove a PropertyChangeListener for a specific property. Ifpclwas added more than once to the same event source for the specified property, it will be notified one less time after being removed. Ifnameis null, no exception is thrown and no action is taken. Ifpclis null, or was never added for the specified property, no exception is thrown and no action is taken.- Specified by:
- removePropertyChangeListenerin interface- BeanContextChild
- Parameters:
- name- The name of the property that was listened on
- pcl- The PropertyChangeListener to be removed
 
- 
addVetoableChangeListenerDeprecated, for removal: This API element is subject to removal in a future version.Add a VetoableChangeListener for a specific property. The same listener object may be added more than once. For each property, the listener will be invoked the number of times it was added for that property. Ifnameorvclis null, no exception is thrown and no action is taken.- Specified by:
- addVetoableChangeListenerin interface- BeanContextChild
- Parameters:
- name- The name of the property to listen on
- vcl- The- VetoableChangeListenerto be added
 
- 
removeVetoableChangeListenerDeprecated, for removal: This API element is subject to removal in a future version.Removes aVetoableChangeListener. Ifpclwas added more than once to the same event source for the specified property, it will be notified one less time after being removed. Ifnameis null, no exception is thrown and no action is taken. Ifvclis null, or was never added for the specified property, no exception is thrown and no action is taken.- Specified by:
- removeVetoableChangeListenerin interface- BeanContextChild
- Parameters:
- name- The name of the property that was listened on
- vcl- The- VetoableChangeListenerto be removed
 
- 
serviceRevokedDeprecated, for removal: This API element is subject to removal in a future version.A service provided by the nesting BeanContext has been revoked. Subclasses may override this method in order to implement their own behaviors.- Specified by:
- serviceRevokedin interface- BeanContextServiceRevokedListener
- Parameters:
- bcsre- The- BeanContextServiceRevokedEventfired as a result of a service being revoked
 
- 
serviceAvailableDeprecated, for removal: This API element is subject to removal in a future version.A new service is available from the nesting BeanContext. Subclasses may override this method in order to implement their own behaviors- Specified by:
- serviceAvailablein interface- BeanContextServicesListener
- Parameters:
- bcsae- The BeanContextServiceAvailableEvent fired as a result of a service becoming available
 
- 
getBeanContextChildPeerDeprecated, for removal: This API element is subject to removal in a future version.Gets theBeanContextChildassociated with thisBeanContextChildSupport.- Returns:
- the BeanContextChildpeer of this class
 
- 
isDelegatedpublic boolean isDelegated()Deprecated, for removal: This API element is subject to removal in a future version.Reports whether or not this class is a delegate of another.- Returns:
- true if this class is a delegate of another
 
- 
firePropertyChangeDeprecated, for removal: This API element is subject to removal in a future version.Report a bound property update to any registered listeners. No event is fired if old and new are equal and non-null.- Parameters:
- name- The programmatic name of the property that was changed
- oldValue- The old value of the property
- newValue- The new value of the property
 
- 
fireVetoableChangepublic void fireVetoableChange(String name, Object oldValue, Object newValue) throws PropertyVetoException Deprecated, for removal: This API element is subject to removal in a future version.Report a vetoable property update to any registered listeners. If anyone vetos the change, then fire a new event reverting everyone to the old value and then rethrow the PropertyVetoException.No event is fired if old and new are equal and non-null. - Parameters:
- name- The programmatic name of the property that is about to change
- oldValue- The old value of the property
- newValue- - The new value of the property
- Throws:
- PropertyVetoException- if the recipient wishes the property change to be rolled back.
 
- 
validatePendingSetBeanContextDeprecated, for removal: This API element is subject to removal in a future version.Called from setBeanContext to validate (or otherwise) the pending change in the nesting BeanContext property value. Returning false will cause setBeanContext to throw PropertyVetoException.- Parameters:
- newValue- the new value that has been requested for the BeanContext property
- Returns:
- trueif the change operation is to be vetoed
 
- 
releaseBeanContextResourcesprotected void releaseBeanContextResources()Deprecated, for removal: This API element is subject to removal in a future version.This method may be overridden by subclasses to provide their own release behaviors. When invoked any resources held by this instance obtained from its current BeanContext property should be released since the object is no longer nested within that BeanContext.
- 
initializeBeanContextResourcesprotected void initializeBeanContextResources()Deprecated, for removal: This API element is subject to removal in a future version.This method may be overridden by subclasses to provide their own initialization behaviors. When invoked any resources required by the BeanContextChild should be obtained from the current BeanContext.
 
-