- java.lang.Object
- 
- java.beans.beancontext.BeanContextChildSupport
- 
- java.beans.beancontext.BeanContextSupport
 
 
- 
- All Implemented Interfaces:
- BeanContext,- BeanContextChild,- BeanContextServiceRevokedListener,- BeanContextServicesListener,- DesignMode,- PropertyChangeListener,- VetoableChangeListener,- Visibility,- Serializable,- Iterable,- Collection,- EventListener
 - Direct Known Subclasses:
- BeanContextServicesSupport
 
 public class BeanContextSupport extends BeanContextChildSupport implements BeanContext, Serializable, PropertyChangeListener, VetoableChangeListener This helper class provides a utility implementation of the java.beans.beancontext.BeanContext interface.Since this class directly implements the BeanContext interface, the class can, and is intended to be used either by subclassing this implementation, or via ad-hoc delegation of an instance of this class from another. - Since:
- 1.2
- See Also:
- Serialized Form
 
- 
- 
Nested Class SummaryNested Classes Modifier and Type Class Description protected classBeanContextSupport.BCSChildprotected static classBeanContextSupport.BCSIteratorprotected final subclass that encapsulates an iterator but implements a noop remove() method.
 - 
Field SummaryFields Modifier and Type Field Description protected ArrayList<BeanContextMembershipListener>bcmListenersall accesses to theprotected ArrayList bcmListenersfield shall be synchronized on that object.protected HashMap<Object,BeanContextSupport.BCSChild>childrenall accesses to theprotected HashMap childrenfield shall be synchronized on that object.protected booleandesignTimeAbooleanindicating whether or not this object is currently in design time mode.protected LocalelocaleThe current locale of this BeanContext.protected booleanokToUseGuiAbooleanindicating if this instance may now render a GUI.- 
Fields declared in class java.beans.beancontext.BeanContextChildSupportbeanContext, beanContextChildPeer, pcSupport, rejectedSetBCOnce, vcSupport
 - 
Fields declared in interface java.beans.beancontext.BeanContextglobalHierarchyLock
 - 
Fields declared in interface java.beans.DesignModePROPERTYNAME
 
- 
 - 
Constructor SummaryConstructors Constructor Description BeanContextSupport()Create an instance that is not a delegate of another objectBeanContextSupport(BeanContext peer)Create an instance using with a default localeBeanContextSupport(BeanContext peer, Locale lcle)Create an instance using the specified localeBeanContextSupport(BeanContext peer, Locale lcle, boolean dtime)Create an instance using the specified Locale and design mode.BeanContextSupport(BeanContext peer, Locale lcle, boolean dTime, boolean visible)Construct a BeanContextSupport instance
 - 
Method SummaryAll Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description booleanadd(Object targetChild)Adds/nests a child within thisBeanContext.booleanaddAll(Collection c)add Collection to set of Children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected fieldvoidaddBeanContextMembershipListener(BeanContextMembershipListener bcml)Adds a BeanContextMembershipListenerbooleanavoidingGui()Used to determine if theBeanContextchild is avoiding using its GUI.protected Iterator<BeanContextSupport.BCSChild>bcsChildren()Returns an iterator of all children of thisBeanContext.protected voidbcsPreDeserializationHook(ObjectInputStream ois)called by readObject after defaultReadObject() but prior to deserialization of any children.protected voidbcsPreSerializationHook(ObjectOutputStream oos)called by writeObject after defaultWriteObject() but prior to serialization of currently serializable children.protected voidchildDeserializedHook(Object child, BeanContextSupport.BCSChild bcsc)Called by readObject with the newly deserialized child and BCSChild.protected voidchildJustAddedHook(Object child, BeanContextSupport.BCSChild bcsc)subclasses may override this method to simply extend add() semantics after the child has been added and before the event notification has occurred.protected voidchildJustRemovedHook(Object child, BeanContextSupport.BCSChild bcsc)subclasses may override this method to simply extend remove() semantics after the child has been removed and before the event notification has occurred.protected static booleanclassEquals(Class<?> first, Class<?> second)Tests to see if two class objects, or their names are equal.voidclear()clear the children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected fieldbooleancontains(Object o)Determines whether or not the specified object is currently a child of thisBeanContext.booleancontainsAll(Collection c)Tests to see if all objects in the specifiedCollectionare children of thisBeanContext.booleancontainsKey(Object o)Determines whether or not the specified object is currently a child of thisBeanContext.protected Object[]copyChildren()Gets a copy of the this BeanContext's children.protected BeanContextSupport.BCSChildcreateBCSChild(Object targetChild, Object peer)Subclasses can override this method to insert their own subclass of Child without having to override add() or the other Collection methods that add children to the set.protected voiddeserialize(ObjectInputStream ois, Collection coll)used by readObject to deserialize a collection.voiddontUseGui()notify this instance that it may no longer render a GUI.protected voidfireChildrenAdded(BeanContextMembershipEvent bcme)Fire a BeanContextshipEvent on the BeanContextMembershipListener interfaceprotected voidfireChildrenRemoved(BeanContextMembershipEvent bcme)Fire a BeanContextshipEvent on the BeanContextMembershipListener interfaceBeanContextgetBeanContextPeer()Gets the instance ofBeanContextthat this object is providing the implementation for.protected static BeanContextChildgetChildBeanContextChild(Object child)Gets the BeanContextChild (if any) of the specified childprotected static BeanContextMembershipListenergetChildBeanContextMembershipListener(Object child)Gets the BeanContextMembershipListener (if any) of the specified childprotected static PropertyChangeListenergetChildPropertyChangeListener(Object child)Gets the PropertyChangeListener (if any) of the specified childprotected static SerializablegetChildSerializable(Object child)Gets the Serializable (if any) associated with the specified Childprotected static VetoableChangeListenergetChildVetoableChangeListener(Object child)Gets the VetoableChangeListener (if any) of the specified childprotected static VisibilitygetChildVisibility(Object child)Gets the Component (if any) associated with the specified child.LocalegetLocale()Gets the locale for thisBeanContext.URLgetResource(String name, BeanContextChild bcc)Analagous tojava.lang.ClassLoader.getResource(), this method allows aBeanContextimplementation to interpose behavior between the childComponentand underlyingClassLoader.InputStreamgetResourceAsStream(String name, BeanContextChild bcc)Analagous tojava.lang.ClassLoader.getResourceAsStream(), this method allows aBeanContextimplementation to interpose behavior between the childComponentand underlyingClassLoader.protected voidinitialize()protected method called from constructor and readObject to initialize transient state of BeanContextSupport instance.ObjectinstantiateChild(String beanName)The instantiateChild method is a convenience hook in BeanContext to simplify the task of instantiating a Bean, nested, into aBeanContext.booleanisDesignTime()Reports whether or not this object is in currently in design time mode.booleanisEmpty()Reports whether or not thisBeanContextis empty.booleanisSerializing()Is thisBeanContextin the process of being serialized?Iterator<Object>iterator()Gets all JavaBean orBeanContextinstances currently nested in thisBeanContext.booleanneedsGui()This method is typically called from the environment in order to determine if the implementor "needs" a GUI.voidokToUseGui()Notify this instance that it may now render a GUIvoidpropertyChange(PropertyChangeEvent pce)subclasses may envelope to monitor child property changes.voidreadChildren(ObjectInputStream ois)When an instance of this class is used as a delegate for the implementation of the BeanContext protocols (and its subprotocols) there exists a 'chicken and egg' problem during deserializationbooleanremove(Object targetChild)Removes a child from this BeanContext.protected booleanremove(Object targetChild, boolean callChildSetBC)internal remove used when removal caused by unexpectedsetBeanContextor byremove()invocation.booleanremoveAll(Collection c)remove all specified children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected fieldvoidremoveBeanContextMembershipListener(BeanContextMembershipListener bcml)Removes a BeanContextMembershipListenerbooleanretainAll(Collection c)retain only specified children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected fieldprotected voidserialize(ObjectOutputStream oos, Collection<?> coll)Used by writeObject to serialize a Collection.voidsetDesignTime(boolean dTime)Sets the new design time value for thisBeanContext.voidsetLocale(Locale newLocale)Sets the locale of this BeanContext.intsize()Gets the number of children currently nested in this BeanContext.Object[]toArray()Gets all JavaBean orBeanContextinstances currently nested in this BeanContext.Object[]toArray(Object[] arry)Gets an array containing all children of thisBeanContextthat match the types contained in arry.protected booleanvalidatePendingAdd(Object targetChild)Subclasses of this class may override, or envelope, this method to add validation behavior for the BeanContext to examine child objects immediately prior to their being added to the BeanContext.protected booleanvalidatePendingRemove(Object targetChild)Subclasses of this class may override, or envelope, this method to add validation behavior for the BeanContext to examine child objects immediately prior to their being removed from the BeanContext.voidvetoableChange(PropertyChangeEvent pce)subclasses may envelope to monitor veto child property changes.voidwriteChildren(ObjectOutputStream oos)Used to serialize all children of thisBeanContext.- 
Methods declared in class java.beans.beancontext.BeanContextChildSupportaddPropertyChangeListener, addVetoableChangeListener, firePropertyChange, fireVetoableChange, getBeanContext, getBeanContextChildPeer, initializeBeanContextResources, isDelegated, releaseBeanContextResources, removePropertyChangeListener, removeVetoableChangeListener, serviceAvailable, serviceRevoked, setBeanContext, validatePendingSetBeanContext
 - 
Methods declared in class java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 - 
Methods declared in interface java.beans.beancontext.BeanContextChildaddPropertyChangeListener, addVetoableChangeListener, getBeanContext, removePropertyChangeListener, removeVetoableChangeListener, setBeanContext
 - 
Methods declared in interface java.util.Collectionequals, hashCode, parallelStream, removeIf, spliterator, stream, toArray
 
- 
 
- 
- 
- 
Field Detail- 
childrenprotected transient HashMap<Object,BeanContextSupport.BCSChild> children all accesses to theprotected HashMap childrenfield shall be synchronized on that object.
 - 
bcmListenersprotected transient ArrayList<BeanContextMembershipListener> bcmListeners all accesses to theprotected ArrayList bcmListenersfield shall be synchronized on that object.
 - 
localeprotected Locale locale The current locale of this BeanContext.
 - 
okToUseGuiprotected boolean okToUseGui Abooleanindicating if this instance may now render a GUI.
 - 
designTimeprotected boolean designTime Abooleanindicating whether or not this object is currently in design time mode.
 
- 
 - 
Constructor Detail- 
BeanContextSupportpublic BeanContextSupport(BeanContext peer, Locale lcle, boolean dTime, boolean visible) Construct a BeanContextSupport instance- Parameters:
- peer- The peer- BeanContextwe are supplying an implementation for, or- nullif this object is its own peer
- lcle- The current Locale for this BeanContext. If- lcleis- null, the default locale is assigned to the- BeanContextinstance.
- dTime- The initial state,- trueif in design mode,- falseif runtime.
- visible- The initial visibility.
- See Also:
- Locale.getDefault(),- Locale.setDefault(java.util.Locale)
 
 - 
BeanContextSupportpublic BeanContextSupport(BeanContext peer, Locale lcle, boolean dtime) Create an instance using the specified Locale and design mode.- Parameters:
- peer- The peer- BeanContextwe are supplying an implementation for, or- nullif this object is its own peer
- lcle- The current Locale for this- BeanContext. If- lcleis- null, the default locale is assigned to the- BeanContextinstance.
- dtime- The initial state,- trueif in design mode,- falseif runtime.
- See Also:
- Locale.getDefault(),- Locale.setDefault(java.util.Locale)
 
 - 
BeanContextSupportpublic BeanContextSupport(BeanContext peer, Locale lcle) Create an instance using the specified locale- Parameters:
- peer- The peer BeanContext we are supplying an implementation for, or- nullif this object is its own peer
- lcle- The current Locale for this- BeanContext. If- lcleis- null, the default locale is assigned to the- BeanContextinstance.
- See Also:
- Locale.getDefault(),- Locale.setDefault(java.util.Locale)
 
 - 
BeanContextSupportpublic BeanContextSupport(BeanContext peer) Create an instance using with a default locale- Parameters:
- peer- The peer- BeanContextwe are supplying an implementation for, or- nullif this object is its own peer
 
 - 
BeanContextSupportpublic BeanContextSupport() Create an instance that is not a delegate of another object
 
- 
 - 
Method Detail- 
getBeanContextPeerpublic BeanContext getBeanContextPeer() Gets the instance ofBeanContextthat this object is providing the implementation for.- Returns:
- the BeanContext instance
 
 - 
instantiateChildpublic Object instantiateChild(String beanName) throws IOException, ClassNotFoundException The instantiateChild method is a convenience hook in BeanContext to simplify the task of instantiating a Bean, nested, into a BeanContext.The semantics of the beanName parameter are defined by java.beans.Beans.instantiate. - Specified by:
- instantiateChildin interface- BeanContext
- Parameters:
- beanName- the name of the Bean to instantiate within this BeanContext
- Returns:
- the new object
- Throws:
- IOException- if there is an I/O error when the bean is being deserialized
- ClassNotFoundException- if the class identified by the beanName parameter is not found
 
 - 
sizepublic int size() Gets the number of children currently nested in this BeanContext.- Specified by:
- sizein interface- Collection
- Returns:
- number of children
 
 - 
isEmptypublic boolean isEmpty() Reports whether or not thisBeanContextis empty. ABeanContextis considered empty when it contains zero nested children.- Specified by:
- isEmptyin interface- Collection
- Returns:
- if there are not children
 
 - 
containspublic boolean contains(Object o) Determines whether or not the specified object is currently a child of thisBeanContext.- Specified by:
- containsin interface- Collection
- Parameters:
- o- the Object in question
- Returns:
- if this object is a child
 
 - 
containsKeypublic boolean containsKey(Object o) Determines whether or not the specified object is currently a child of thisBeanContext.- Parameters:
- o- the Object in question
- Returns:
- if this object is a child
 
 - 
iteratorpublic Iterator<Object> iterator() Gets all JavaBean orBeanContextinstances currently nested in thisBeanContext.- Specified by:
- iteratorin interface- Collection
- Specified by:
- iteratorin interface- Iterable
- Returns:
- an Iteratorof the nested children
 
 - 
toArraypublic Object[] toArray() Gets all JavaBean orBeanContextinstances currently nested in this BeanContext.- Specified by:
- toArrayin interface- Collection
- Returns:
- an array, whose runtime component
 type is Object, containing all of the elements in this collection
 
 - 
toArraypublic Object[] toArray(Object[] arry) Gets an array containing all children of thisBeanContextthat match the types contained in arry.- Specified by:
- toArrayin interface- Collection
- Parameters:
- arry- The array of object types that are of interest.
- Returns:
- an array of children
 
 - 
createBCSChildprotected BeanContextSupport.BCSChild createBCSChild(Object targetChild, Object peer) Subclasses can override this method to insert their own subclass of Child without having to override add() or the other Collection methods that add children to the set. - Parameters:
- targetChild- the child to create the Child on behalf of
- peer- the peer if the tragetChild and the peer are related by an implementation of BeanContextProxy
- Returns:
- Subtype-specific subclass of Child without overriding collection methods
 
 - 
addpublic boolean add(Object targetChild) Adds/nests a child within thisBeanContext.Invoked as a side effect of java.beans.Beans.instantiate(). If the child object is not valid for adding then this method throws an IllegalStateException. - Specified by:
- addin interface- Collection
- Parameters:
- targetChild- The child objects to nest within this- BeanContext
- Returns:
- true if the child was added successfully.
- See Also:
- validatePendingAdd(java.lang.Object)
 
 - 
removepublic boolean remove(Object targetChild) Removes a child from this BeanContext. If the child object is not for adding then this method throws an IllegalStateException.- Specified by:
- removein interface- Collection
- Parameters:
- targetChild- The child objects to remove
- Returns:
- trueif an element was removed as a result of this call
- See Also:
- validatePendingRemove(java.lang.Object)
 
 - 
removeprotected boolean remove(Object targetChild, boolean callChildSetBC) internal remove used when removal caused by unexpectedsetBeanContextor byremove()invocation.- Parameters:
- targetChild- the JavaBean, BeanContext, or Object to be removed
- callChildSetBC- used to indicate that the child should be notified that it is no longer nested in this- BeanContext.
- Returns:
- whether or not was present before being removed
 
 - 
containsAllpublic boolean containsAll(Collection c) Tests to see if all objects in the specifiedCollectionare children of thisBeanContext.- Specified by:
- containsAllin interface- Collection
- Parameters:
- c- the specified- Collection
- Returns:
- trueif all objects in the collection are children of this- BeanContext, false if not.
- See Also:
- Collection.contains(Object)
 
 - 
addAllpublic boolean addAll(Collection c) add Collection to set of Children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field- Specified by:
- addAllin interface- Collection
- Parameters:
- c- collection containing elements to be added to this collection
- Returns:
- this implementation unconditionally throws UnsupportedOperationException
- Throws:
- UnsupportedOperationException- thrown unconditionally by this implementation
- See Also:
- Collection.add(Object)
 
 - 
removeAllpublic boolean removeAll(Collection c) remove all specified children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field- Specified by:
- removeAllin interface- Collection
- Parameters:
- c- collection containing elements to be removed from this collection
- Returns:
- this implementation unconditionally throws UnsupportedOperationException
- Throws:
- UnsupportedOperationException- thrown unconditionally by this implementation
- See Also:
- Collection.remove(Object),- Collection.contains(Object)
 
 - 
retainAllpublic boolean retainAll(Collection c) retain only specified children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field- Specified by:
- retainAllin interface- Collection
- Parameters:
- c- collection containing elements to be retained in this collection
- Returns:
- this implementation unconditionally throws UnsupportedOperationException
- Throws:
- UnsupportedOperationException- thrown unconditionally by this implementation
- See Also:
- Collection.remove(Object),- Collection.contains(Object)
 
 - 
clearpublic void clear() clear the children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field- Specified by:
- clearin interface- Collection
- Throws:
- UnsupportedOperationException- thrown unconditionally by this implementation
 
 - 
addBeanContextMembershipListenerpublic void addBeanContextMembershipListener(BeanContextMembershipListener bcml) Adds a BeanContextMembershipListener- Specified by:
- addBeanContextMembershipListenerin interface- BeanContext
- Parameters:
- bcml- the BeanContextMembershipListener to add
- Throws:
- NullPointerException- if the argument is null
 
 - 
removeBeanContextMembershipListenerpublic void removeBeanContextMembershipListener(BeanContextMembershipListener bcml) Removes a BeanContextMembershipListener- Specified by:
- removeBeanContextMembershipListenerin interface- BeanContext
- Parameters:
- bcml- the BeanContextMembershipListener to remove
- Throws:
- NullPointerException- if the argument is null
 
 - 
getResourceAsStreampublic InputStream getResourceAsStream(String name, BeanContextChild bcc) Description copied from interface:BeanContextAnalagous tojava.lang.ClassLoader.getResourceAsStream(), this method allows aBeanContextimplementation to interpose behavior between the childComponentand underlyingClassLoader.- Specified by:
- getResourceAsStreamin interface- BeanContext
- Parameters:
- name- the name of the resource requested.
- bcc- the child object making the request.
- Returns:
- the requested resource as an InputStream
- Throws:
- NullPointerException- if the argument is null
 
 - 
getResourcepublic URL getResource(String name, BeanContextChild bcc) Description copied from interface:BeanContextAnalagous tojava.lang.ClassLoader.getResource(), this method allows aBeanContextimplementation to interpose behavior between the childComponentand underlyingClassLoader.- Specified by:
- getResourcein interface- BeanContext
- Parameters:
- name- the name of the resource requested.
- bcc- the child object making the request.
- Returns:
- the requested resource as an InputStream
 
 - 
setDesignTimepublic void setDesignTime(boolean dTime) Sets the new design time value for thisBeanContext.- Specified by:
- setDesignTimein interface- DesignMode
- Parameters:
- dTime- the new designTime value
- See Also:
- BeanContext,- BeanContextMembershipListener,- PropertyChangeEvent
 
 - 
isDesignTimepublic boolean isDesignTime() Reports whether or not this object is in currently in design time mode.- Specified by:
- isDesignTimein interface- DesignMode
- Returns:
- trueif in design time mode,- falseif not
 
 - 
setLocalepublic void setLocale(Locale newLocale) throws PropertyVetoException Sets the locale of this BeanContext.- Parameters:
- newLocale- the new locale. This method call will have no effect if newLocale is- null.
- Throws:
- PropertyVetoException- if the new value is rejected
 
 - 
getLocalepublic Locale getLocale() Gets the locale for thisBeanContext.- Returns:
- the current Locale of the BeanContext
 
 - 
needsGuipublic boolean needsGui() This method is typically called from the environment in order to determine if the implementor "needs" a GUI. The algorithm used herein tests the BeanContextPeer, and its current children to determine if they are either Containers, Components, or if they implement Visibility and return needsGui() == true. - Specified by:
- needsGuiin interface- Visibility
- Returns:
- trueif the implementor needs a GUI
 
 - 
dontUseGuipublic void dontUseGui() notify this instance that it may no longer render a GUI.- Specified by:
- dontUseGuiin interface- Visibility
 
 - 
okToUseGuipublic void okToUseGui() Notify this instance that it may now render a GUI- Specified by:
- okToUseGuiin interface- Visibility
 
 - 
avoidingGuipublic boolean avoidingGui() Used to determine if theBeanContextchild is avoiding using its GUI.- Specified by:
- avoidingGuiin interface- Visibility
- Returns:
- is this instance avoiding using its GUI?
- See Also:
- Visibility
 
 - 
isSerializingpublic boolean isSerializing() Is thisBeanContextin the process of being serialized?- Returns:
- if this BeanContextis currently being serialized
 
 - 
bcsChildrenprotected Iterator<BeanContextSupport.BCSChild> bcsChildren() Returns an iterator of all children of thisBeanContext.- Returns:
- an iterator for all the current BCSChild values
 
 - 
bcsPreSerializationHookprotected void bcsPreSerializationHook(ObjectOutputStream oos) throws IOException called by writeObject after defaultWriteObject() but prior to serialization of currently serializable children. This method may be overridden by subclasses to perform custom serialization of their state prior to this superclass serializing the children. This method should not however be used by subclasses to replace their own implementation (if any) of writeObject().- Parameters:
- oos- the- ObjectOutputStreamto use during serialization
- Throws:
- IOException- if serialization failed
 
 - 
bcsPreDeserializationHookprotected void bcsPreDeserializationHook(ObjectInputStream ois) throws IOException, ClassNotFoundException called by readObject after defaultReadObject() but prior to deserialization of any children. This method may be overridden by subclasses to perform custom deserialization of their state prior to this superclass deserializing the children. This method should not however be used by subclasses to replace their own implementation (if any) of readObject().- Parameters:
- ois- the- ObjectInputStreamto use during deserialization
- Throws:
- IOException- if deserialization failed
- ClassNotFoundException- if needed classes are not found
 
 - 
childDeserializedHookprotected void childDeserializedHook(Object child, BeanContextSupport.BCSChild bcsc) Called by readObject with the newly deserialized child and BCSChild.- Parameters:
- child- the newly deserialized child
- bcsc- the newly deserialized BCSChild
 
 - 
serializeprotected final void serialize(ObjectOutputStream oos, Collection<?> coll) throws IOException Used by writeObject to serialize a Collection.- Parameters:
- oos- the- ObjectOutputStreamto use during serialization
- coll- the- Collectionto serialize
- Throws:
- IOException- if serialization failed
 
 - 
deserializeprotected final void deserialize(ObjectInputStream ois, Collection coll) throws IOException, ClassNotFoundException used by readObject to deserialize a collection.- Parameters:
- ois- the ObjectInputStream to use
- coll- the Collection
- Throws:
- IOException- if deserialization failed
- ClassNotFoundException- if needed classes are not found
 
 - 
writeChildrenpublic final void writeChildren(ObjectOutputStream oos) throws IOException Used to serialize all children of thisBeanContext.- Parameters:
- oos- the- ObjectOutputStreamto use during serialization
- Throws:
- IOException- if serialization failed
 
 - 
readChildrenpublic final void readChildren(ObjectInputStream ois) throws IOException, ClassNotFoundException When an instance of this class is used as a delegate for the implementation of the BeanContext protocols (and its subprotocols) there exists a 'chicken and egg' problem during deserialization- Parameters:
- ois- the ObjectInputStream to use
- Throws:
- IOException- if deserialization failed
- ClassNotFoundException- if needed classes are not found
 
 - 
vetoableChangepublic void vetoableChange(PropertyChangeEvent pce) throws PropertyVetoException subclasses may envelope to monitor veto child property changes.- Specified by:
- vetoableChangein interface- VetoableChangeListener
- Parameters:
- pce- a- PropertyChangeEventobject describing the event source and the property that has changed.
- Throws:
- PropertyVetoException- if the recipient wishes the property change to be rolled back.
 
 - 
propertyChangepublic void propertyChange(PropertyChangeEvent pce) subclasses may envelope to monitor child property changes.- Specified by:
- propertyChangein interface- PropertyChangeListener
- Parameters:
- pce- A PropertyChangeEvent object describing the event source and the property that has changed.
 
 - 
validatePendingAddprotected boolean validatePendingAdd(Object targetChild) Subclasses of this class may override, or envelope, this method to add validation behavior for the BeanContext to examine child objects immediately prior to their being added to the BeanContext. - Parameters:
- targetChild- the child to create the Child on behalf of
- Returns:
- true iff the child may be added to this BeanContext, otherwise false.
 
 - 
validatePendingRemoveprotected boolean validatePendingRemove(Object targetChild) Subclasses of this class may override, or envelope, this method to add validation behavior for the BeanContext to examine child objects immediately prior to their being removed from the BeanContext. - Parameters:
- targetChild- the child to create the Child on behalf of
- Returns:
- true iff the child may be removed from this BeanContext, otherwise false.
 
 - 
childJustAddedHookprotected void childJustAddedHook(Object child, BeanContextSupport.BCSChild bcsc) subclasses may override this method to simply extend add() semantics after the child has been added and before the event notification has occurred. The method is called with the child synchronized.- Parameters:
- child- the child
- bcsc- the BCSChild
 
 - 
childJustRemovedHookprotected void childJustRemovedHook(Object child, BeanContextSupport.BCSChild bcsc) subclasses may override this method to simply extend remove() semantics after the child has been removed and before the event notification has occurred. The method is called with the child synchronized.- Parameters:
- child- the child
- bcsc- the BCSChild
 
 - 
getChildVisibilityprotected static final Visibility getChildVisibility(Object child) Gets the Component (if any) associated with the specified child.- Parameters:
- child- the specified child
- Returns:
- the Component (if any) associated with the specified child.
 
 - 
getChildSerializableprotected static final Serializable getChildSerializable(Object child) Gets the Serializable (if any) associated with the specified Child- Parameters:
- child- the specified child
- Returns:
- the Serializable (if any) associated with the specified Child
 
 - 
getChildPropertyChangeListenerprotected static final PropertyChangeListener getChildPropertyChangeListener(Object child) Gets the PropertyChangeListener (if any) of the specified child- Parameters:
- child- the specified child
- Returns:
- the PropertyChangeListener (if any) of the specified child
 
 - 
getChildVetoableChangeListenerprotected static final VetoableChangeListener getChildVetoableChangeListener(Object child) Gets the VetoableChangeListener (if any) of the specified child- Parameters:
- child- the specified child
- Returns:
- the VetoableChangeListener (if any) of the specified child
 
 - 
getChildBeanContextMembershipListenerprotected static final BeanContextMembershipListener getChildBeanContextMembershipListener(Object child) Gets the BeanContextMembershipListener (if any) of the specified child- Parameters:
- child- the specified child
- Returns:
- the BeanContextMembershipListener (if any) of the specified child
 
 - 
getChildBeanContextChildprotected static final BeanContextChild getChildBeanContextChild(Object child) Gets the BeanContextChild (if any) of the specified child- Parameters:
- child- the specified child
- Returns:
- the BeanContextChild (if any) of the specified child
- Throws:
- IllegalArgumentException- if child implements both BeanContextChild and BeanContextProxy
 
 - 
fireChildrenAddedprotected final void fireChildrenAdded(BeanContextMembershipEvent bcme) Fire a BeanContextshipEvent on the BeanContextMembershipListener interface- Parameters:
- bcme- the event to fire
 
 - 
fireChildrenRemovedprotected final void fireChildrenRemoved(BeanContextMembershipEvent bcme) Fire a BeanContextshipEvent on the BeanContextMembershipListener interface- Parameters:
- bcme- the event to fire
 
 - 
initializeprotected void initialize() protected method called from constructor and readObject to initialize transient state of BeanContextSupport instance. This class uses this method to instantiate inner class listeners used to monitor PropertyChange and VetoableChange events on children. subclasses may envelope this method to add their own initialization behavior
 - 
copyChildrenprotected final Object[] copyChildren() Gets a copy of the this BeanContext's children.- Returns:
- a copy of the current nested children
 
 
- 
 
-