java.beans.beancontext
Class BeanContextSupport

java.lang.Object sample code for java.lang.Object definition code for java.lang.Object 
  extended by java.beans.beancontext.BeanContextChildSupport sample code for java.beans.beancontext.BeanContextChildSupport definition code for java.beans.beancontext.BeanContextChildSupport 
      extended by java.beans.beancontext.BeanContextSupport
All Implemented Interfaces:
BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext , BeanContextChild sample code for java.beans.beancontext.BeanContextChild definition code for java.beans.beancontext.BeanContextChild , BeanContextServiceRevokedListener sample code for java.beans.beancontext.BeanContextServiceRevokedListener definition code for java.beans.beancontext.BeanContextServiceRevokedListener , BeanContextServicesListener sample code for java.beans.beancontext.BeanContextServicesListener definition code for java.beans.beancontext.BeanContextServicesListener , DesignMode sample code for java.beans.DesignMode definition code for java.beans.DesignMode , PropertyChangeListener sample code for java.beans.PropertyChangeListener definition code for java.beans.PropertyChangeListener , VetoableChangeListener sample code for java.beans.VetoableChangeListener definition code for java.beans.VetoableChangeListener , Visibility sample code for java.beans.Visibility definition code for java.beans.Visibility , Serializable sample code for java.io.Serializable definition code for java.io.Serializable , Iterable sample code for java.lang.Iterable definition code for java.lang.Iterable , Collection sample code for java.util.Collection definition code for java.util.Collection , EventListener sample code for java.util.EventListener definition code for java.util.EventListener
Direct Known Subclasses:
BeanContextServicesSupport sample code for java.beans.beancontext.BeanContextServicesSupport definition code for java.beans.beancontext.BeanContextServicesSupport

public class BeanContextSupport
extends BeanContextChildSupport sample code for java.beans.beancontext.BeanContextChildSupport definition code for java.beans.beancontext.BeanContextChildSupport
implements BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext , Serializable sample code for java.io.Serializable definition code for java.io.Serializable , PropertyChangeListener sample code for java.beans.PropertyChangeListener definition code for java.beans.PropertyChangeListener , VetoableChangeListener sample code for java.beans.VetoableChangeListener definition code for java.beans.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 Summary
protected  class BeanContextSupport.BCSChild sample code for java.beans.beancontext.BeanContextSupport.BCSChild definition code for java.beans.beancontext.BeanContextSupport.BCSChild
           
protected static class BeanContextSupport.BCSIterator sample code for java.beans.beancontext.BeanContextSupport.BCSIterator definition code for java.beans.beancontext.BeanContextSupport.BCSIterator
          protected final subclass that encapsulates an iterator but implements a noop remove() method.
 
Field Summary
protected  ArrayList sample code for java.util.ArrayList definition code for java.util.ArrayList bcmListeners sample code for java.beans.beancontext.BeanContextSupport.bcmListeners definition code for java.beans.beancontext.BeanContextSupport.bcmListeners
          all accesses to the protected ArrayList bcmListeners field shall be synchronized on that object.
protected  HashMap sample code for java.util.HashMap definition code for java.util.HashMap children sample code for java.beans.beancontext.BeanContextSupport.children definition code for java.beans.beancontext.BeanContextSupport.children
          all accesses to the protected HashMap children field shall be synchronized on that object.
protected  boolean designTime sample code for java.beans.beancontext.BeanContextSupport.designTime definition code for java.beans.beancontext.BeanContextSupport.designTime
          A boolean indicating whether or not this object is currently in design time mode.
protected  Locale sample code for java.util.Locale definition code for java.util.Locale locale sample code for java.beans.beancontext.BeanContextSupport.locale definition code for java.beans.beancontext.BeanContextSupport.locale
          The current locale of this BeanContext.
protected  boolean okToUseGui sample code for java.beans.beancontext.BeanContextSupport.okToUseGui definition code for java.beans.beancontext.BeanContextSupport.okToUseGui
          A boolean indicating if this instance may now render a GUI.
 
Fields inherited from class java.beans.beancontext.BeanContextChildSupport sample code for java.beans.beancontext.BeanContextChildSupport definition code for java.beans.beancontext.BeanContextChildSupport
beanContext sample code for java.beans.beancontext.BeanContextChildSupport.beanContext definition code for java.beans.beancontext.BeanContextChildSupport.beanContext , beanContextChildPeer sample code for java.beans.beancontext.BeanContextChildSupport.beanContextChildPeer definition code for java.beans.beancontext.BeanContextChildSupport.beanContextChildPeer , pcSupport sample code for java.beans.beancontext.BeanContextChildSupport.pcSupport definition code for java.beans.beancontext.BeanContextChildSupport.pcSupport , rejectedSetBCOnce sample code for java.beans.beancontext.BeanContextChildSupport.rejectedSetBCOnce definition code for java.beans.beancontext.BeanContextChildSupport.rejectedSetBCOnce , vcSupport sample code for java.beans.beancontext.BeanContextChildSupport.vcSupport definition code for java.beans.beancontext.BeanContextChildSupport.vcSupport
 
Fields inherited from interface java.beans.beancontext.BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext
globalHierarchyLock sample code for java.beans.beancontext.BeanContext.globalHierarchyLock definition code for java.beans.beancontext.BeanContext.globalHierarchyLock
 
Fields inherited from interface java.beans.DesignMode sample code for java.beans.DesignMode definition code for java.beans.DesignMode
PROPERTYNAME sample code for java.beans.DesignMode.PROPERTYNAME definition code for java.beans.DesignMode.PROPERTYNAME
 
Constructor Summary
BeanContextSupport sample code for java.beans.beancontext.BeanContextSupport.BeanContextSupport() definition code for java.beans.beancontext.BeanContextSupport.BeanContextSupport() ()
          Create an instance that is not a delegate of another object
BeanContextSupport sample code for java.beans.beancontext.BeanContextSupport.BeanContextSupport(java.beans.beancontext.BeanContext) definition code for java.beans.beancontext.BeanContextSupport.BeanContextSupport(java.beans.beancontext.BeanContext) (BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext  peer)
          Create an instance using with a default locale
BeanContextSupport sample code for java.beans.beancontext.BeanContextSupport.BeanContextSupport(java.beans.beancontext.BeanContext, java.util.Locale) definition code for java.beans.beancontext.BeanContextSupport.BeanContextSupport(java.beans.beancontext.BeanContext, java.util.Locale) (BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext  peer, Locale sample code for java.util.Locale definition code for java.util.Locale  lcle)
          Create an instance using the specified locale
BeanContextSupport sample code for java.beans.beancontext.BeanContextSupport.BeanContextSupport(java.beans.beancontext.BeanContext, java.util.Locale, boolean) definition code for java.beans.beancontext.BeanContextSupport.BeanContextSupport(java.beans.beancontext.BeanContext, java.util.Locale, boolean) (BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext  peer, Locale sample code for java.util.Locale definition code for java.util.Locale  lcle, boolean dtime)
          Create an instance using the specified Locale and design mode.
BeanContextSupport sample code for java.beans.beancontext.BeanContextSupport.BeanContextSupport(java.beans.beancontext.BeanContext, java.util.Locale, boolean, boolean) definition code for java.beans.beancontext.BeanContextSupport.BeanContextSupport(java.beans.beancontext.BeanContext, java.util.Locale, boolean, boolean) (BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext  peer, Locale sample code for java.util.Locale definition code for java.util.Locale  lcle, boolean dTime, boolean visible)
          Construct a BeanContextSupport instance
 
Method Summary
 boolean add sample code for java.beans.beancontext.BeanContextSupport.add(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.add(java.lang.Object) (Object sample code for java.lang.Object definition code for java.lang.Object  targetChild)
          Adds/nests a child within this BeanContext.
 boolean addAll sample code for java.beans.beancontext.BeanContextSupport.addAll(java.util.Collection) definition code for java.beans.beancontext.BeanContextSupport.addAll(java.util.Collection) (Collection sample code for java.util.Collection definition code for java.util.Collection  c)
          add Collection to set of Children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field
 void addBeanContextMembershipListener sample code for java.beans.beancontext.BeanContextSupport.addBeanContextMembershipListener(java.beans.beancontext.BeanContextMembershipListener) definition code for java.beans.beancontext.BeanContextSupport.addBeanContextMembershipListener(java.beans.beancontext.BeanContextMembershipListener) (BeanContextMembershipListener sample code for java.beans.beancontext.BeanContextMembershipListener definition code for java.beans.beancontext.BeanContextMembershipListener  bcml)
          Adds a BeanContextMembershipListener
 boolean avoidingGui sample code for java.beans.beancontext.BeanContextSupport.avoidingGui() definition code for java.beans.beancontext.BeanContextSupport.avoidingGui() ()
          Used to determine if the BeanContext child is avoiding using its GUI.
protected  Iterator sample code for java.util.Iterator definition code for java.util.Iterator bcsChildren sample code for java.beans.beancontext.BeanContextSupport.bcsChildren() definition code for java.beans.beancontext.BeanContextSupport.bcsChildren() ()
          Returns an iterator of all children of this BeanContext.
protected  void bcsPreDeserializationHook sample code for java.beans.beancontext.BeanContextSupport.bcsPreDeserializationHook(java.io.ObjectInputStream) definition code for java.beans.beancontext.BeanContextSupport.bcsPreDeserializationHook(java.io.ObjectInputStream) (ObjectInputStream sample code for java.io.ObjectInputStream definition code for java.io.ObjectInputStream  ois)
          called by readObject after defaultReadObject() but prior to deserialization of any children.
protected  void bcsPreSerializationHook sample code for java.beans.beancontext.BeanContextSupport.bcsPreSerializationHook(java.io.ObjectOutputStream) definition code for java.beans.beancontext.BeanContextSupport.bcsPreSerializationHook(java.io.ObjectOutputStream) (ObjectOutputStream sample code for java.io.ObjectOutputStream definition code for java.io.ObjectOutputStream  oos)
          called by writeObject after defaultWriteObject() but prior to serialization of currently serializable children.
protected  void childDeserializedHook sample code for java.beans.beancontext.BeanContextSupport.childDeserializedHook(java.lang.Object, java.beans.beancontext.BeanContextSupport.BCSChild) definition code for java.beans.beancontext.BeanContextSupport.childDeserializedHook(java.lang.Object, java.beans.beancontext.BeanContextSupport.BCSChild) (Object sample code for java.lang.Object definition code for java.lang.Object  child, BeanContextSupport.BCSChild sample code for java.beans.beancontext.BeanContextSupport.BCSChild definition code for java.beans.beancontext.BeanContextSupport.BCSChild  bcsc)
          Called by readObject with the newly deserialized child and BCSChild.
protected  void childJustAddedHook sample code for java.beans.beancontext.BeanContextSupport.childJustAddedHook(java.lang.Object, java.beans.beancontext.BeanContextSupport.BCSChild) definition code for java.beans.beancontext.BeanContextSupport.childJustAddedHook(java.lang.Object, java.beans.beancontext.BeanContextSupport.BCSChild) (Object sample code for java.lang.Object definition code for java.lang.Object  child, BeanContextSupport.BCSChild sample code for java.beans.beancontext.BeanContextSupport.BCSChild definition code for java.beans.beancontext.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  void childJustRemovedHook sample code for java.beans.beancontext.BeanContextSupport.childJustRemovedHook(java.lang.Object, java.beans.beancontext.BeanContextSupport.BCSChild) definition code for java.beans.beancontext.BeanContextSupport.childJustRemovedHook(java.lang.Object, java.beans.beancontext.BeanContextSupport.BCSChild) (Object sample code for java.lang.Object definition code for java.lang.Object  child, BeanContextSupport.BCSChild sample code for java.beans.beancontext.BeanContextSupport.BCSChild definition code for java.beans.beancontext.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 boolean classEquals sample code for java.beans.beancontext.BeanContextSupport.classEquals(java.lang.Class, java.lang.Class) definition code for java.beans.beancontext.BeanContextSupport.classEquals(java.lang.Class, java.lang.Class) (Class sample code for java.lang.Class definition code for java.lang.Class  first, Class sample code for java.lang.Class definition code for java.lang.Class  second)
          Tests to see if two class objects, or their names are equal.
 void clear sample code for java.beans.beancontext.BeanContextSupport.clear() definition code for java.beans.beancontext.BeanContextSupport.clear() ()
          clear the children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field
 boolean contains sample code for java.beans.beancontext.BeanContextSupport.contains(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.contains(java.lang.Object) (Object sample code for java.lang.Object definition code for java.lang.Object  o)
          Determines whether or not the specified object is currently a child of this BeanContext.
 boolean containsAll sample code for java.beans.beancontext.BeanContextSupport.containsAll(java.util.Collection) definition code for java.beans.beancontext.BeanContextSupport.containsAll(java.util.Collection) (Collection sample code for java.util.Collection definition code for java.util.Collection  c)
          Tests to see if all objects in the specified Collection are children of this BeanContext.
 boolean containsKey sample code for java.beans.beancontext.BeanContextSupport.containsKey(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.containsKey(java.lang.Object) (Object sample code for java.lang.Object definition code for java.lang.Object  o)
          Determines whether or not the specified object is currently a child of this BeanContext.
protected  Object sample code for java.lang.Object definition code for java.lang.Object [] copyChildren sample code for java.beans.beancontext.BeanContextSupport.copyChildren() definition code for java.beans.beancontext.BeanContextSupport.copyChildren() ()
          Gets a copy of the this BeanContext's children.
protected  BeanContextSupport.BCSChild sample code for java.beans.beancontext.BeanContextSupport.BCSChild definition code for java.beans.beancontext.BeanContextSupport.BCSChild createBCSChild sample code for java.beans.beancontext.BeanContextSupport.createBCSChild(java.lang.Object, java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.createBCSChild(java.lang.Object, java.lang.Object) (Object sample code for java.lang.Object definition code for java.lang.Object  targetChild, Object sample code for java.lang.Object definition code for java.lang.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  void deserialize sample code for java.beans.beancontext.BeanContextSupport.deserialize(java.io.ObjectInputStream, java.util.Collection) definition code for java.beans.beancontext.BeanContextSupport.deserialize(java.io.ObjectInputStream, java.util.Collection) (ObjectInputStream sample code for java.io.ObjectInputStream definition code for java.io.ObjectInputStream  ois, Collection sample code for java.util.Collection definition code for java.util.Collection  coll)
          used by readObject to deserialize a collection.
 void dontUseGui sample code for java.beans.beancontext.BeanContextSupport.dontUseGui() definition code for java.beans.beancontext.BeanContextSupport.dontUseGui() ()
          notify this instance that it may no longer render a GUI.
protected  void fireChildrenAdded sample code for java.beans.beancontext.BeanContextSupport.fireChildrenAdded(java.beans.beancontext.BeanContextMembershipEvent) definition code for java.beans.beancontext.BeanContextSupport.fireChildrenAdded(java.beans.beancontext.BeanContextMembershipEvent) (BeanContextMembershipEvent sample code for java.beans.beancontext.BeanContextMembershipEvent definition code for java.beans.beancontext.BeanContextMembershipEvent  bcme)
          Fire a BeanContextshipEvent on the BeanContextMembershipListener interface
protected  void fireChildrenRemoved sample code for java.beans.beancontext.BeanContextSupport.fireChildrenRemoved(java.beans.beancontext.BeanContextMembershipEvent) definition code for java.beans.beancontext.BeanContextSupport.fireChildrenRemoved(java.beans.beancontext.BeanContextMembershipEvent) (BeanContextMembershipEvent sample code for java.beans.beancontext.BeanContextMembershipEvent definition code for java.beans.beancontext.BeanContextMembershipEvent  bcme)
          Fire a BeanContextshipEvent on the BeanContextMembershipListener interface
 BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext getBeanContextPeer sample code for java.beans.beancontext.BeanContextSupport.getBeanContextPeer() definition code for java.beans.beancontext.BeanContextSupport.getBeanContextPeer() ()
          Gets the instance of BeanContext that this object is providing the implementation for.
protected static BeanContextChild sample code for java.beans.beancontext.BeanContextChild definition code for java.beans.beancontext.BeanContextChild getChildBeanContextChild sample code for java.beans.beancontext.BeanContextSupport.getChildBeanContextChild(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.getChildBeanContextChild(java.lang.Object) (Object sample code for java.lang.Object definition code for java.lang.Object  child)
          Gets the BeanContextChild (if any) of the specified child
protected static BeanContextMembershipListener sample code for java.beans.beancontext.BeanContextMembershipListener definition code for java.beans.beancontext.BeanContextMembershipListener getChildBeanContextMembershipListener sample code for java.beans.beancontext.BeanContextSupport.getChildBeanContextMembershipListener(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.getChildBeanContextMembershipListener(java.lang.Object) (Object sample code for java.lang.Object definition code for java.lang.Object  child)
          Gets the BeanContextMembershipListener (if any) of the specified child
protected static PropertyChangeListener sample code for java.beans.PropertyChangeListener definition code for java.beans.PropertyChangeListener getChildPropertyChangeListener sample code for java.beans.beancontext.BeanContextSupport.getChildPropertyChangeListener(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.getChildPropertyChangeListener(java.lang.Object) (Object sample code for java.lang.Object definition code for java.lang.Object  child)
          Gets the PropertyChangeListener (if any) of the specified child
protected static Serializable sample code for java.io.Serializable definition code for java.io.Serializable getChildSerializable sample code for java.beans.beancontext.BeanContextSupport.getChildSerializable(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.getChildSerializable(java.lang.Object) (Object sample code for java.lang.Object definition code for java.lang.Object  child)
          Gets the Serializable (if any) associated with the specified Child
protected static VetoableChangeListener sample code for java.beans.VetoableChangeListener definition code for java.beans.VetoableChangeListener getChildVetoableChangeListener sample code for java.beans.beancontext.BeanContextSupport.getChildVetoableChangeListener(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.getChildVetoableChangeListener(java.lang.Object) (Object sample code for java.lang.Object definition code for java.lang.Object  child)
          Gets the VetoableChangeListener (if any) of the specified child
protected static Visibility sample code for java.beans.Visibility definition code for java.beans.Visibility getChildVisibility sample code for java.beans.beancontext.BeanContextSupport.getChildVisibility(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.getChildVisibility(java.lang.Object) (Object sample code for java.lang.Object definition code for java.lang.Object  child)
          Gets the Component (if any) associated with the specified child.
 Locale sample code for java.util.Locale definition code for java.util.Locale getLocale sample code for java.beans.beancontext.BeanContextSupport.getLocale() definition code for java.beans.beancontext.BeanContextSupport.getLocale() ()
          Gets the locale for this BeanContext.
 URL sample code for java.net.URL definition code for java.net.URL getResource sample code for java.beans.beancontext.BeanContextSupport.getResource(java.lang.String, java.beans.beancontext.BeanContextChild) definition code for java.beans.beancontext.BeanContextSupport.getResource(java.lang.String, java.beans.beancontext.BeanContextChild) (String sample code for java.lang.String definition code for java.lang.String  name, BeanContextChild sample code for java.beans.beancontext.BeanContextChild definition code for java.beans.beancontext.BeanContextChild  bcc)
          Analagous to java.lang.ClassLoader.getResource(), this method allows a BeanContext implementation to interpose behavior between the child Component and underlying ClassLoader.
 InputStream sample code for java.io.InputStream definition code for java.io.InputStream getResourceAsStream sample code for java.beans.beancontext.BeanContextSupport.getResourceAsStream(java.lang.String, java.beans.beancontext.BeanContextChild) definition code for java.beans.beancontext.BeanContextSupport.getResourceAsStream(java.lang.String, java.beans.beancontext.BeanContextChild) (String sample code for java.lang.String definition code for java.lang.String  name, BeanContextChild sample code for java.beans.beancontext.BeanContextChild definition code for java.beans.beancontext.BeanContextChild  bcc)
          Analagous to java.lang.ClassLoader.getResourceAsStream(), this method allows a BeanContext implementation to interpose behavior between the child Component and underlying ClassLoader.
protected  void initialize sample code for java.beans.beancontext.BeanContextSupport.initialize() definition code for java.beans.beancontext.BeanContextSupport.initialize() ()
          protected method called from constructor and readObject to initialize transient state of BeanContextSupport instance.
 Object sample code for java.lang.Object definition code for java.lang.Object instantiateChild sample code for java.beans.beancontext.BeanContextSupport.instantiateChild(java.lang.String) definition code for java.beans.beancontext.BeanContextSupport.instantiateChild(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  beanName)
           The instantiateChild method is a convenience hook in BeanContext to simplify the task of instantiating a Bean, nested, into a BeanContext.
 boolean isDesignTime sample code for java.beans.beancontext.BeanContextSupport.isDesignTime() definition code for java.beans.beancontext.BeanContextSupport.isDesignTime() ()
          Reports whether or not this object is in currently in design time mode.
 boolean isEmpty sample code for java.beans.beancontext.BeanContextSupport.isEmpty() definition code for java.beans.beancontext.BeanContextSupport.isEmpty() ()
          Reports whether or not this BeanContext is empty.
 boolean isSerializing sample code for java.beans.beancontext.BeanContextSupport.isSerializing() definition code for java.beans.beancontext.BeanContextSupport.isSerializing() ()
          Is this BeanContext in the process of being serialized?
 Iterator sample code for java.util.Iterator definition code for java.util.Iterator iterator sample code for java.beans.beancontext.BeanContextSupport.iterator() definition code for java.beans.beancontext.BeanContextSupport.iterator() ()
          Gets all JavaBean or BeanContext instances currently nested in this BeanContext.
 boolean needsGui sample code for java.beans.beancontext.BeanContextSupport.needsGui() definition code for java.beans.beancontext.BeanContextSupport.needsGui() ()
           This method is typically called from the environment in order to determine if the implementor "needs" a GUI.
 void okToUseGui sample code for java.beans.beancontext.BeanContextSupport.okToUseGui() definition code for java.beans.beancontext.BeanContextSupport.okToUseGui() ()
          Notify this instance that it may now render a GUI
 void propertyChange sample code for java.beans.beancontext.BeanContextSupport.propertyChange(java.beans.PropertyChangeEvent) definition code for java.beans.beancontext.BeanContextSupport.propertyChange(java.beans.PropertyChangeEvent) (PropertyChangeEvent sample code for java.beans.PropertyChangeEvent definition code for java.beans.PropertyChangeEvent  pce)
          subclasses may envelope to monitor child property changes.
 void readChildren sample code for java.beans.beancontext.BeanContextSupport.readChildren(java.io.ObjectInputStream) definition code for java.beans.beancontext.BeanContextSupport.readChildren(java.io.ObjectInputStream) (ObjectInputStream sample code for java.io.ObjectInputStream definition code for java.io.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 deserialization
 boolean remove sample code for java.beans.beancontext.BeanContextSupport.remove(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.remove(java.lang.Object) (Object sample code for java.lang.Object definition code for java.lang.Object  targetChild)
          Removes a child from this BeanContext.
protected  boolean remove sample code for java.beans.beancontext.BeanContextSupport.remove(java.lang.Object, boolean) definition code for java.beans.beancontext.BeanContextSupport.remove(java.lang.Object, boolean) (Object sample code for java.lang.Object definition code for java.lang.Object  targetChild, boolean callChildSetBC)
          internal remove used when removal caused by unexpected setBeanContext or by remove() invocation.
 boolean removeAll sample code for java.beans.beancontext.BeanContextSupport.removeAll(java.util.Collection) definition code for java.beans.beancontext.BeanContextSupport.removeAll(java.util.Collection) (Collection sample code for java.util.Collection definition code for java.util.Collection  c)
          remove all specified children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field
 void removeBeanContextMembershipListener sample code for java.beans.beancontext.BeanContextSupport.removeBeanContextMembershipListener(java.beans.beancontext.BeanContextMembershipListener) definition code for java.beans.beancontext.BeanContextSupport.removeBeanContextMembershipListener(java.beans.beancontext.BeanContextMembershipListener) (BeanContextMembershipListener sample code for java.beans.beancontext.BeanContextMembershipListener definition code for java.beans.beancontext.BeanContextMembershipListener  bcml)
          Removes a BeanContextMembershipListener
 boolean retainAll sample code for java.beans.beancontext.BeanContextSupport.retainAll(java.util.Collection) definition code for java.beans.beancontext.BeanContextSupport.retainAll(java.util.Collection) (Collection sample code for java.util.Collection definition code for java.util.Collection  c)
          retain only specified children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field
protected  void serialize sample code for java.beans.beancontext.BeanContextSupport.serialize(java.io.ObjectOutputStream, java.util.Collection) definition code for java.beans.beancontext.BeanContextSupport.serialize(java.io.ObjectOutputStream, java.util.Collection) (ObjectOutputStream sample code for java.io.ObjectOutputStream definition code for java.io.ObjectOutputStream  oos, Collection sample code for java.util.Collection definition code for java.util.Collection  coll)
          Used by writeObject to serialize a Collection.
 void setDesignTime sample code for java.beans.beancontext.BeanContextSupport.setDesignTime(boolean) definition code for java.beans.beancontext.BeanContextSupport.setDesignTime(boolean) (boolean dTime)
          Sets the new design time value for this BeanContext.
 void setLocale sample code for java.beans.beancontext.BeanContextSupport.setLocale(java.util.Locale) definition code for java.beans.beancontext.BeanContextSupport.setLocale(java.util.Locale) (Locale sample code for java.util.Locale definition code for java.util.Locale  newLocale)
          Sets the locale of this BeanContext.
 int size sample code for java.beans.beancontext.BeanContextSupport.size() definition code for java.beans.beancontext.BeanContextSupport.size() ()
          Gets the number of children currently nested in this BeanContext.
 Object sample code for java.lang.Object definition code for java.lang.Object [] toArray sample code for java.beans.beancontext.BeanContextSupport.toArray() definition code for java.beans.beancontext.BeanContextSupport.toArray() ()
          Gets all JavaBean or BeanContext instances currently nested in this BeanContext.
 Object sample code for java.lang.Object definition code for java.lang.Object [] toArray sample code for java.beans.beancontext.BeanContextSupport.toArray(java.lang.Object[]) definition code for java.beans.beancontext.BeanContextSupport.toArray(java.lang.Object[]) (Object sample code for java.lang.Object definition code for java.lang.Object [] arry)
          Gets an array containing all children of this BeanContext that match the types contained in arry.
protected  boolean validatePendingAdd sample code for java.beans.beancontext.BeanContextSupport.validatePendingAdd(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.validatePendingAdd(java.lang.Object) (Object sample code for java.lang.Object definition code for java.lang.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  boolean validatePendingRemove sample code for java.beans.beancontext.BeanContextSupport.validatePendingRemove(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.validatePendingRemove(java.lang.Object) (Object sample code for java.lang.Object definition code for java.lang.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.
 void vetoableChange sample code for java.beans.beancontext.BeanContextSupport.vetoableChange(java.beans.PropertyChangeEvent) definition code for java.beans.beancontext.BeanContextSupport.vetoableChange(java.beans.PropertyChangeEvent) (PropertyChangeEvent sample code for java.beans.PropertyChangeEvent definition code for java.beans.PropertyChangeEvent  pce)
          subclasses may envelope to monitor veto child property changes.
 void writeChildren sample code for java.beans.beancontext.BeanContextSupport.writeChildren(java.io.ObjectOutputStream) definition code for java.beans.beancontext.BeanContextSupport.writeChildren(java.io.ObjectOutputStream) (ObjectOutputStream sample code for java.io.ObjectOutputStream definition code for java.io.ObjectOutputStream  oos)
          Used to serialize all children of this BeanContext.
 
Methods inherited from class java.beans.beancontext.BeanContextChildSupport sample code for java.beans.beancontext.BeanContextChildSupport definition code for java.beans.beancontext.BeanContextChildSupport
addPropertyChangeListener sample code for java.beans.beancontext.BeanContextChildSupport.addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener) definition code for java.beans.beancontext.BeanContextChildSupport.addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener) , addVetoableChangeListener sample code for java.beans.beancontext.BeanContextChildSupport.addVetoableChangeListener(java.lang.String, java.beans.VetoableChangeListener) definition code for java.beans.beancontext.BeanContextChildSupport.addVetoableChangeListener(java.lang.String, java.beans.VetoableChangeListener) , firePropertyChange sample code for java.beans.beancontext.BeanContextChildSupport.firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object) definition code for java.beans.beancontext.BeanContextChildSupport.firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object) , fireVetoableChange sample code for java.beans.beancontext.BeanContextChildSupport.fireVetoableChange(java.lang.String, java.lang.Object, java.lang.Object) definition code for java.beans.beancontext.BeanContextChildSupport.fireVetoableChange(java.lang.String, java.lang.Object, java.lang.Object) , getBeanContext sample code for java.beans.beancontext.BeanContextChildSupport.getBeanContext() definition code for java.beans.beancontext.BeanContextChildSupport.getBeanContext() , getBeanContextChildPeer sample code for java.beans.beancontext.BeanContextChildSupport.getBeanContextChildPeer() definition code for java.beans.beancontext.BeanContextChildSupport.getBeanContextChildPeer() , initializeBeanContextResources sample code for java.beans.beancontext.BeanContextChildSupport.initializeBeanContextResources() definition code for java.beans.beancontext.BeanContextChildSupport.initializeBeanContextResources() , isDelegated sample code for java.beans.beancontext.BeanContextChildSupport.isDelegated() definition code for java.beans.beancontext.BeanContextChildSupport.isDelegated() , releaseBeanContextResources sample code for java.beans.beancontext.BeanContextChildSupport.releaseBeanContextResources() definition code for java.beans.beancontext.BeanContextChildSupport.releaseBeanContextResources() , removePropertyChangeListener sample code for java.beans.beancontext.BeanContextChildSupport.removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener) definition code for java.beans.beancontext.BeanContextChildSupport.removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener) , removeVetoableChangeListener sample code for java.beans.beancontext.BeanContextChildSupport.removeVetoableChangeListener(java.lang.String, java.beans.VetoableChangeListener) definition code for java.beans.beancontext.BeanContextChildSupport.removeVetoableChangeListener(java.lang.String, java.beans.VetoableChangeListener) , serviceAvailable sample code for java.beans.beancontext.BeanContextChildSupport.serviceAvailable(java.beans.beancontext.BeanContextServiceAvailableEvent) definition code for java.beans.beancontext.BeanContextChildSupport.serviceAvailable(java.beans.beancontext.BeanContextServiceAvailableEvent) , serviceRevoked sample code for java.beans.beancontext.BeanContextChildSupport.serviceRevoked(java.beans.beancontext.BeanContextServiceRevokedEvent) definition code for java.beans.beancontext.BeanContextChildSupport.serviceRevoked(java.beans.beancontext.BeanContextServiceRevokedEvent) , setBeanContext sample code for java.beans.beancontext.BeanContextChildSupport.setBeanContext(java.beans.beancontext.BeanContext) definition code for java.beans.beancontext.BeanContextChildSupport.setBeanContext(java.beans.beancontext.BeanContext) , validatePendingSetBeanContext sample code for java.beans.beancontext.BeanContextChildSupport.validatePendingSetBeanContext(java.beans.beancontext.BeanContext) definition code for java.beans.beancontext.BeanContextChildSupport.validatePendingSetBeanContext(java.beans.beancontext.BeanContext)
 
Methods inherited from class java.lang.Object sample code for java.lang.Object definition code for java.lang.Object
clone sample code for java.lang.Object.clone() definition code for java.lang.Object.clone() , equals sample code for java.lang.Object.equals(java.lang.Object) definition code for java.lang.Object.equals(java.lang.Object) , finalize sample code for java.lang.Object.finalize() definition code for java.lang.Object.finalize() , getClass sample code for java.lang.Object.getClass() definition code for java.lang.Object.getClass() , hashCode sample code for java.lang.Object.hashCode() definition code for java.lang.Object.hashCode() , notify sample code for java.lang.Object.notify() definition code for java.lang.Object.notify() , notifyAll sample code for java.lang.Object.notifyAll() definition code for java.lang.Object.notifyAll() , toString sample code for java.lang.Object.toString() definition code for java.lang.Object.toString() , wait sample code for java.lang.Object.wait() definition code for java.lang.Object.wait() , wait sample code for java.lang.Object.wait(long) definition code for java.lang.Object.wait(long) , wait sample code for java.lang.Object.wait(long, int) definition code for java.lang.Object.wait(long, int)
 
Methods inherited from interface java.beans.beancontext.BeanContextChild sample code for java.beans.beancontext.BeanContextChild definition code for java.beans.beancontext.BeanContextChild
addPropertyChangeListener sample code for java.beans.beancontext.BeanContextChild.addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener) definition code for java.beans.beancontext.BeanContextChild.addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener) , addVetoableChangeListener sample code for java.beans.beancontext.BeanContextChild.addVetoableChangeListener(java.lang.String, java.beans.VetoableChangeListener) definition code for java.beans.beancontext.BeanContextChild.addVetoableChangeListener(java.lang.String, java.beans.VetoableChangeListener) , getBeanContext sample code for java.beans.beancontext.BeanContextChild.getBeanContext() definition code for java.beans.beancontext.BeanContextChild.getBeanContext() , removePropertyChangeListener sample code for java.beans.beancontext.BeanContextChild.removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener) definition code for java.beans.beancontext.BeanContextChild.removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener) , removeVetoableChangeListener sample code for java.beans.beancontext.BeanContextChild.removeVetoableChangeListener(java.lang.String, java.beans.VetoableChangeListener) definition code for java.beans.beancontext.BeanContextChild.removeVetoableChangeListener(java.lang.String, java.beans.VetoableChangeListener) , setBeanContext sample code for java.beans.beancontext.BeanContextChild.setBeanContext(java.beans.beancontext.BeanContext) definition code for java.beans.beancontext.BeanContextChild.setBeanContext(java.beans.beancontext.BeanContext)
 
Methods inherited from interface java.util.Collection sample code for java.util.Collection definition code for java.util.Collection
equals sample code for java.util.Collection.equals(java.lang.Object) definition code for java.util.Collection.equals(java.lang.Object) , hashCode sample code for java.util.Collection.hashCode() definition code for java.util.Collection.hashCode()
 

Field Detail

children sample code for java.beans.beancontext.BeanContextSupport.children

protected transient HashMap sample code for java.util.HashMap definition code for java.util.HashMap  children
all accesses to the protected HashMap children field shall be synchronized on that object.


bcmListeners sample code for java.beans.beancontext.BeanContextSupport.bcmListeners

protected transient ArrayList sample code for java.util.ArrayList definition code for java.util.ArrayList  bcmListeners
all accesses to the protected ArrayList bcmListeners field shall be synchronized on that object.


locale sample code for java.beans.beancontext.BeanContextSupport.locale

protected Locale sample code for java.util.Locale definition code for java.util.Locale  locale
The current locale of this BeanContext.


okToUseGui sample code for java.beans.beancontext.BeanContextSupport.okToUseGui

protected boolean okToUseGui
A boolean indicating if this instance may now render a GUI.


designTime sample code for java.beans.beancontext.BeanContextSupport.designTime

protected boolean designTime
A boolean indicating whether or not this object is currently in design time mode.

Constructor Detail

BeanContextSupport sample code for java.beans.beancontext.BeanContextSupport(java.beans.beancontext.BeanContext, java.util.Locale, boolean, boolean) definition code for java.beans.beancontext.BeanContextSupport(java.beans.beancontext.BeanContext, java.util.Locale, boolean, boolean)

public BeanContextSupport(BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext  peer,
                          Locale sample code for java.util.Locale definition code for java.util.Locale  lcle,
                          boolean dTime,
                          boolean visible)
Construct a BeanContextSupport instance

Parameters:
peer - The peer BeanContext we are supplying an implementation for, or null if this object is its own peer
lcle - The current Locale for this BeanContext. If lcle is null, the default locale is assigned to the BeanContext instance.
dTime - The initial state, true if in design mode, false if runtime.
visible - The initial visibility.
See Also:
Locale.getDefault() sample code for java.util.Locale.getDefault() definition code for java.util.Locale.getDefault() , Locale.setDefault(java.util.Locale) sample code for java.util.Locale.setDefault(java.util.Locale) definition code for java.util.Locale.setDefault(java.util.Locale)

BeanContextSupport sample code for java.beans.beancontext.BeanContextSupport(java.beans.beancontext.BeanContext, java.util.Locale, boolean) definition code for java.beans.beancontext.BeanContextSupport(java.beans.beancontext.BeanContext, java.util.Locale, boolean)

public BeanContextSupport(BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext  peer,
                          Locale sample code for java.util.Locale definition code for java.util.Locale  lcle,
                          boolean dtime)
Create an instance using the specified Locale and design mode.

Parameters:
peer - The peer BeanContext we are supplying an implementation for, or null if this object is its own peer
lcle - The current Locale for this BeanContext. If lcle is null, the default locale is assigned to the BeanContext instance.
dtime - The initial state, true if in design mode, false if runtime.
See Also:
Locale.getDefault() sample code for java.util.Locale.getDefault() definition code for java.util.Locale.getDefault() , Locale.setDefault(java.util.Locale) sample code for java.util.Locale.setDefault(java.util.Locale) definition code for java.util.Locale.setDefault(java.util.Locale)

BeanContextSupport sample code for java.beans.beancontext.BeanContextSupport(java.beans.beancontext.BeanContext, java.util.Locale) definition code for java.beans.beancontext.BeanContextSupport(java.beans.beancontext.BeanContext, java.util.Locale)

public BeanContextSupport(BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext  peer,
                          Locale sample code for java.util.Locale definition code for java.util.Locale  lcle)
Create an instance using the specified locale

Parameters:
peer - The peer BeanContext we are supplying an implementation for, or null if this object is its own peer
lcle - The current Locale for this BeanContext. If lcle is null, the default locale is assigned to the BeanContext instance.
See Also:
Locale.getDefault() sample code for java.util.Locale.getDefault() definition code for java.util.Locale.getDefault() , Locale.setDefault(java.util.Locale) sample code for java.util.Locale.setDefault(java.util.Locale) definition code for java.util.Locale.setDefault(java.util.Locale)

BeanContextSupport sample code for java.beans.beancontext.BeanContextSupport(java.beans.beancontext.BeanContext) definition code for java.beans.beancontext.BeanContextSupport(java.beans.beancontext.BeanContext)

public BeanContextSupport(BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext  peer)
Create an instance using with a default locale

Parameters:
peer - The peer BeanContext we are supplying an implementation for, or null if this object is its own peer

BeanContextSupport sample code for java.beans.beancontext.BeanContextSupport() definition code for java.beans.beancontext.BeanContextSupport()

public BeanContextSupport()
Create an instance that is not a delegate of another object

Method Detail

getBeanContextPeer sample code for java.beans.beancontext.BeanContextSupport.getBeanContextPeer() definition code for java.beans.beancontext.BeanContextSupport.getBeanContextPeer()

public BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext  getBeanContextPeer()
Gets the instance of BeanContext that this object is providing the implementation for.

Returns:
the BeanContext instance

instantiateChild sample code for java.beans.beancontext.BeanContextSupport.instantiateChild(java.lang.String) definition code for java.beans.beancontext.BeanContextSupport.instantiateChild(java.lang.String)

public Object sample code for java.lang.Object definition code for java.lang.Object  instantiateChild(String sample code for java.lang.String definition code for java.lang.String  beanName)
                        throws IOException sample code for java.io.IOException definition code for java.io.IOException ,
                               ClassNotFoundException sample code for java.lang.ClassNotFoundException definition code for java.lang.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.instantate.

Specified by:
instantiateChild sample code for java.beans.beancontext.BeanContext.instantiateChild(java.lang.String) definition code for java.beans.beancontext.BeanContext.instantiateChild(java.lang.String) in interface BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext
Parameters:
beanName - the name of the Bean to instantiate within this BeanContext
Returns:
the new object
Throws:
IOException sample code for java.io.IOException definition code for java.io.IOException - if there is an I/O error when the bean is being deserialized
ClassNotFoundException sample code for java.lang.ClassNotFoundException definition code for java.lang.ClassNotFoundException - if the class identified by the beanName parameter is not found

size sample code for java.beans.beancontext.BeanContextSupport.size() definition code for java.beans.beancontext.BeanContextSupport.size()

public int size()
Gets the number of children currently nested in this BeanContext.

Specified by:
size sample code for java.util.Collection.size() definition code for java.util.Collection.size() in interface Collection sample code for java.util.Collection definition code for java.util.Collection
Returns:
number of children

isEmpty sample code for java.beans.beancontext.BeanContextSupport.isEmpty() definition code for java.beans.beancontext.BeanContextSupport.isEmpty()

public boolean isEmpty()
Reports whether or not this BeanContext is empty. A BeanContext is considered empty when it contains zero nested children.

Specified by:
isEmpty sample code for java.util.Collection.isEmpty() definition code for java.util.Collection.isEmpty() in interface Collection sample code for java.util.Collection definition code for java.util.Collection
Returns:
if there are not children

contains sample code for java.beans.beancontext.BeanContextSupport.contains(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.contains(java.lang.Object)

public boolean contains(Object sample code for java.lang.Object definition code for java.lang.Object  o)
Determines whether or not the specified object is currently a child of this BeanContext.

Specified by:
contains sample code for java.util.Collection.contains(java.lang.Object) definition code for java.util.Collection.contains(java.lang.Object) in interface Collection sample code for java.util.Collection definition code for java.util.Collection
Parameters:
o - the Object in question
Returns:
if this object is a child

containsKey sample code for java.beans.beancontext.BeanContextSupport.containsKey(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.containsKey(java.lang.Object)

public boolean containsKey(Object sample code for java.lang.Object definition code for java.lang.Object  o)
Determines whether or not the specified object is currently a child of this BeanContext.

Parameters:
o - the Object in question
Returns:
if this object is a child

iterator sample code for java.beans.beancontext.BeanContextSupport.iterator() definition code for java.beans.beancontext.BeanContextSupport.iterator()

public Iterator sample code for java.util.Iterator definition code for java.util.Iterator  iterator()
Gets all JavaBean or BeanContext instances currently nested in this BeanContext.

Specified by:
iterator sample code for java.lang.Iterable.iterator() definition code for java.lang.Iterable.iterator() in interface Iterable sample code for java.lang.Iterable definition code for java.lang.Iterable
Specified by:
iterator sample code for java.util.Collection.iterator() definition code for java.util.Collection.iterator() in interface Collection sample code for java.util.Collection definition code for java.util.Collection
Returns:
an Iterator of the nested children

toArray sample code for java.beans.beancontext.BeanContextSupport.toArray() definition code for java.beans.beancontext.BeanContextSupport.toArray()

public Object sample code for java.lang.Object definition code for java.lang.Object [] toArray()
Gets all JavaBean or BeanContext instances currently nested in this BeanContext.

Specified by:
toArray sample code for java.util.Collection.toArray() definition code for java.util.Collection.toArray() in interface Collection sample code for java.util.Collection definition code for java.util.Collection
Returns:
an array containing all of the elements in this collection

toArray sample code for java.beans.beancontext.BeanContextSupport.toArray(java.lang.Object[]) definition code for java.beans.beancontext.BeanContextSupport.toArray(java.lang.Object[])

public Object sample code for java.lang.Object definition code for java.lang.Object [] toArray(Object sample code for java.lang.Object definition code for java.lang.Object [] arry)
Gets an array containing all children of this BeanContext that match the types contained in arry.

Specified by:
toArray sample code for java.util.Collection.toArray(T[]) definition code for java.util.Collection.toArray(T[]) in interface Collection sample code for java.util.Collection definition code for java.util.Collection
Parameters:
arry - The array of object types that are of interest.
Returns:
an array of children

createBCSChild sample code for java.beans.beancontext.BeanContextSupport.createBCSChild(java.lang.Object, java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.createBCSChild(java.lang.Object, java.lang.Object)

protected BeanContextSupport.BCSChild sample code for java.beans.beancontext.BeanContextSupport.BCSChild definition code for java.beans.beancontext.BeanContextSupport.BCSChild  createBCSChild(Object sample code for java.lang.Object definition code for java.lang.Object  targetChild,
                                                     Object sample code for java.lang.Object definition code for java.lang.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

add sample code for java.beans.beancontext.BeanContextSupport.add(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.add(java.lang.Object)

public boolean add(Object sample code for java.lang.Object definition code for java.lang.Object  targetChild)
Adds/nests a child within this BeanContext.

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:
add sample code for java.util.Collection.add(E) definition code for java.util.Collection.add(E) in interface Collection sample code for java.util.Collection definition code for java.util.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) sample code for java.beans.beancontext.BeanContextSupport.validatePendingAdd(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.validatePendingAdd(java.lang.Object)

remove sample code for java.beans.beancontext.BeanContextSupport.remove(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.remove(java.lang.Object)

public boolean remove(Object sample code for java.lang.Object definition code for java.lang.Object  targetChild)
Removes a child from this BeanContext. If the child object is not for adding then this method throws an IllegalStateException.

Specified by:
remove sample code for java.util.Collection.remove(java.lang.Object) definition code for java.util.Collection.remove(java.lang.Object) in interface Collection sample code for java.util.Collection definition code for java.util.Collection
Parameters:
targetChild - The child objects to remove
Returns:
true if this collection changed as a result of the call
See Also:
validatePendingRemove(java.lang.Object) sample code for java.beans.beancontext.BeanContextSupport.validatePendingRemove(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.validatePendingRemove(java.lang.Object)

remove sample code for java.beans.beancontext.BeanContextSupport.remove(java.lang.Object, boolean) definition code for java.beans.beancontext.BeanContextSupport.remove(java.lang.Object, boolean)

protected boolean remove(Object sample code for java.lang.Object definition code for java.lang.Object  targetChild,
                         boolean callChildSetBC)
internal remove used when removal caused by unexpected setBeanContext or by remove() 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.

containsAll sample code for java.beans.beancontext.BeanContextSupport.containsAll(java.util.Collection) definition code for java.beans.beancontext.BeanContextSupport.containsAll(java.util.Collection)

public boolean containsAll(Collection sample code for java.util.Collection definition code for java.util.Collection  c)
Tests to see if all objects in the specified Collection are children of this BeanContext.

Specified by:
containsAll sample code for java.util.Collection.containsAll(java.util.Collection) definition code for java.util.Collection.containsAll(java.util.Collection) in interface Collection sample code for java.util.Collection definition code for java.util.Collection
Parameters:
c - the specified Collection
Returns:
true if all objects in the collection are children of this BeanContext, false if not.
See Also:
Collection.contains(Object) sample code for java.util.Collection.contains(java.lang.Object) definition code for java.util.Collection.contains(java.lang.Object)

addAll sample code for java.beans.beancontext.BeanContextSupport.addAll(java.util.Collection) definition code for java.beans.beancontext.BeanContextSupport.addAll(java.util.Collection)

public boolean addAll(Collection sample code for java.util.Collection definition code for java.util.Collection  c)
add Collection to set of Children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field

Specified by:
addAll sample code for java.util.Collection.addAll(java.util.Collection) definition code for java.util.Collection.addAll(java.util.Collection) in interface Collection sample code for java.util.Collection definition code for java.util.Collection
Parameters:
c - elements to be inserted into this collection.
Returns:
true if this collection changed as a result of the call
Throws:
UnsupportedOperationException sample code for java.lang.UnsupportedOperationException definition code for java.lang.UnsupportedOperationException
See Also:
Collection.add(Object) sample code for java.util.Collection.add(E) definition code for java.util.Collection.add(E)

removeAll sample code for java.beans.beancontext.BeanContextSupport.removeAll(java.util.Collection) definition code for java.beans.beancontext.BeanContextSupport.removeAll(java.util.Collection)

public boolean removeAll(Collection sample code for java.util.Collection definition code for java.util.Collection  c)
remove all specified children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field

Specified by:
removeAll sample code for java.util.Collection.removeAll(java.util.Collection) definition code for java.util.Collection.removeAll(java.util.Collection) in interface Collection sample code for java.util.Collection definition code for java.util.Collection
Parameters:
c - elements to be removed from this collection.
Returns:
true if this collection changed as a result of the call
Throws:
UnsupportedOperationException sample code for java.lang.UnsupportedOperationException definition code for java.lang.UnsupportedOperationException
See Also:
Collection.remove(Object) sample code for java.util.Collection.remove(java.lang.Object) definition code for java.util.Collection.remove(java.lang.Object) , Collection.contains(Object) sample code for java.util.Collection.contains(java.lang.Object) definition code for java.util.Collection.contains(java.lang.Object)

retainAll sample code for java.beans.beancontext.BeanContextSupport.retainAll(java.util.Collection) definition code for java.beans.beancontext.BeanContextSupport.retainAll(java.util.Collection)

public boolean retainAll(Collection sample code for java.util.Collection definition code for java.util.Collection  c)
retain only specified children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field

Specified by:
retainAll sample code for java.util.Collection.retainAll(java.util.Collection) definition code for java.util.Collection.retainAll(java.util.Collection) in interface Collection sample code for java.util.Collection definition code for java.util.Collection
Parameters:
c - elements to be retained in this collection.
Returns:
true if this collection changed as a result of the call
Throws:
UnsupportedOperationException sample code for java.lang.UnsupportedOperationException definition code for java.lang.UnsupportedOperationException
See Also:
Collection.remove(Object) sample code for java.util.Collection.remove(java.lang.Object) definition code for java.util.Collection.remove(java.lang.Object) , Collection.contains(Object) sample code for java.util.Collection.contains(java.lang.Object) definition code for java.util.Collection.contains(java.lang.Object)

clear sample code for java.beans.beancontext.BeanContextSupport.clear() definition code for java.beans.beancontext.BeanContextSupport.clear()

public void clear()
clear the children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field

Specified by:
clear sample code for java.util.Collection.clear() definition code for java.util.Collection.clear() in interface Collection sample code for java.util.Collection definition code for java.util.Collection
Throws:
UnsupportedOperationException sample code for java.lang.UnsupportedOperationException definition code for java.lang.UnsupportedOperationException

addBeanContextMembershipListener sample code for java.beans.beancontext.BeanContextSupport.addBeanContextMembershipListener(java.beans.beancontext.BeanContextMembershipListener) definition code for java.beans.beancontext.BeanContextSupport.addBeanContextMembershipListener(java.beans.beancontext.BeanContextMembershipListener)

public void addBeanContextMembershipListener(BeanContextMembershipListener sample code for java.beans.beancontext.BeanContextMembershipListener definition code for java.beans.beancontext.BeanContextMembershipListener  bcml)
Adds a BeanContextMembershipListener

Specified by:
addBeanContextMembershipListener sample code for java.beans.beancontext.BeanContext.addBeanContextMembershipListener(java.beans.beancontext.BeanContextMembershipListener) definition code for java.beans.beancontext.BeanContext.addBeanContextMembershipListener(java.beans.beancontext.BeanContextMembershipListener) in interface BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext
Parameters:
bcml - the BeanContextMembershipListener to add
Throws:
NullPointerException sample code for java.lang.NullPointerException definition code for java.lang.NullPointerException

removeBeanContextMembershipListener sample code for java.beans.beancontext.BeanContextSupport.removeBeanContextMembershipListener(java.beans.beancontext.BeanContextMembershipListener) definition code for java.beans.beancontext.BeanContextSupport.removeBeanContextMembershipListener(java.beans.beancontext.BeanContextMembershipListener)

public void removeBeanContextMembershipListener(BeanContextMembershipListener sample code for java.beans.beancontext.BeanContextMembershipListener definition code for java.beans.beancontext.BeanContextMembershipListener  bcml)
Removes a BeanContextMembershipListener

Specified by:
removeBeanContextMembershipListener sample code for java.beans.beancontext.BeanContext.removeBeanContextMembershipListener(java.beans.beancontext.BeanContextMembershipListener) definition code for java.beans.beancontext.BeanContext.removeBeanContextMembershipListener(java.beans.beancontext.BeanContextMembershipListener) in interface BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext
Parameters:
bcml - the BeanContextMembershipListener to remove
Throws:
NullPointerException sample code for java.lang.NullPointerException definition code for java.lang.NullPointerException

getResourceAsStream sample code for java.beans.beancontext.BeanContextSupport.getResourceAsStream(java.lang.String, java.beans.beancontext.BeanContextChild) definition code for java.beans.beancontext.BeanContextSupport.getResourceAsStream(java.lang.String, java.beans.beancontext.BeanContextChild)

public InputStream sample code for java.io.InputStream definition code for java.io.InputStream  getResourceAsStream(String sample code for java.lang.String definition code for java.lang.String  name,
                                       BeanContextChild sample code for java.beans.beancontext.BeanContextChild definition code for java.beans.beancontext.BeanContextChild  bcc)
Description copied from interface: BeanContext sample code for java.beans.beancontext.BeanContext.getResourceAsStream(java.lang.String, java.beans.beancontext.BeanContextChild) definition code for java.beans.beancontext.BeanContext.getResourceAsStream(java.lang.String, java.beans.beancontext.BeanContextChild)
Analagous to java.lang.ClassLoader.getResourceAsStream(), this method allows a BeanContext implementation to interpose behavior between the child Component and underlying ClassLoader.

Specified by:
getResourceAsStream sample code for java.beans.beancontext.BeanContext.getResourceAsStream(java.lang.String, java.beans.beancontext.BeanContextChild) definition code for java.beans.beancontext.BeanContext.getResourceAsStream(java.lang.String, java.beans.beancontext.BeanContextChild) in interface BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.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 sample code for java.lang.NullPointerException definition code for java.lang.NullPointerException

getResource sample code for java.beans.beancontext.BeanContextSupport.getResource(java.lang.String, java.beans.beancontext.BeanContextChild) definition code for java.beans.beancontext.BeanContextSupport.getResource(java.lang.String, java.beans.beancontext.BeanContextChild)

public URL sample code for java.net.URL definition code for java.net.URL  getResource(String sample code for java.lang.String definition code for java.lang.String  name,
                       BeanContextChild sample code for java.beans.beancontext.BeanContextChild definition code for java.beans.beancontext.BeanContextChild  bcc)
Description copied from interface: BeanContext sample code for java.beans.beancontext.BeanContext.getResource(java.lang.String, java.beans.beancontext.BeanContextChild) definition code for java.beans.beancontext.BeanContext.getResource(java.lang.String, java.beans.beancontext.BeanContextChild)
Analagous to java.lang.ClassLoader.getResource(), this method allows a BeanContext implementation to interpose behavior between the child Component and underlying ClassLoader.

Specified by:
getResource sample code for java.beans.beancontext.BeanContext.getResource(java.lang.String, java.beans.beancontext.BeanContextChild) definition code for java.beans.beancontext.BeanContext.getResource(java.lang.String, java.beans.beancontext.BeanContextChild) in interface BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext
Parameters:
name - the name of the resource requested.
bcc - the child object making the request.
Returns:
the requested resource as an InputStream

setDesignTime sample code for java.beans.beancontext.BeanContextSupport.setDesignTime(boolean) definition code for java.beans.beancontext.BeanContextSupport.setDesignTime(boolean)

public void setDesignTime(boolean dTime)
Sets the new design time value for this BeanContext.

Specified by:
setDesignTime sample code for java.beans.DesignMode.setDesignTime(boolean) definition code for java.beans.DesignMode.setDesignTime(boolean) in interface DesignMode sample code for java.beans.DesignMode definition code for java.beans.DesignMode
Parameters:
dTime - the new designTime value
See Also:
BeanContext sample code for java.beans.beancontext.BeanContext definition code for java.beans.beancontext.BeanContext , BeanContextMembershipListener sample code for java.beans.beancontext.BeanContextMembershipListener definition code for java.beans.beancontext.BeanContextMembershipListener , PropertyChangeEvent sample code for java.beans.PropertyChangeEvent definition code for java.beans.PropertyChangeEvent

isDesignTime sample code for java.beans.beancontext.BeanContextSupport.isDesignTime() definition code for java.beans.beancontext.BeanContextSupport.isDesignTime()

public boolean isDesignTime()
Reports whether or not this object is in currently in design time mode.

Specified by:
isDesignTime sample code for java.beans.DesignMode.isDesignTime() definition code for java.beans.DesignMode.isDesignTime() in interface DesignMode sample code for java.beans.DesignMode definition code for java.beans.DesignMode
Returns:
true if in design time mode, false if not

setLocale sample code for java.beans.beancontext.BeanContextSupport.setLocale(java.util.Locale) definition code for java.beans.beancontext.BeanContextSupport.setLocale(java.util.Locale)

public void setLocale(Locale sample code for java.util.Locale definition code for java.util.Locale  newLocale)
               throws PropertyVetoException sample code for java.beans.PropertyVetoException definition code for java.beans.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 sample code for java.beans.PropertyVetoException definition code for java.beans.PropertyVetoException - if the new value is rejected

getLocale sample code for java.beans.beancontext.BeanContextSupport.getLocale() definition code for java.beans.beancontext.BeanContextSupport.getLocale()

public Locale sample code for java.util.Locale definition code for java.util.Locale  getLocale()
Gets the locale for this BeanContext.

Returns:
the current Locale of the BeanContext

needsGui sample code for java.beans.beancontext.BeanContextSupport.needsGui() definition code for java.beans.beancontext.BeanContextSupport.needsGui()

public 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:
needsGui sample code for java.beans.Visibility.needsGui() definition code for java.beans.Visibility.needsGui() in interface Visibility sample code for java.beans.Visibility definition code for java.beans.Visibility
Returns:
true if the implementor needs a GUI

dontUseGui sample code for java.beans.beancontext.BeanContextSupport.dontUseGui() definition code for java.beans.beancontext.BeanContextSupport.dontUseGui()

public void dontUseGui()
notify this instance that it may no longer render a GUI.

Specified by:
dontUseGui sample code for java.beans.Visibility.dontUseGui() definition code for java.beans.Visibility.dontUseGui() in interface Visibility sample code for java.beans.Visibility definition code for java.beans.Visibility

okToUseGui sample code for java.beans.beancontext.BeanContextSupport.okToUseGui() definition code for java.beans.beancontext.BeanContextSupport.okToUseGui()

public void okToUseGui()
Notify this instance that it may now render a GUI

Specified by:
okToUseGui sample code for java.beans.Visibility.okToUseGui() definition code for java.beans.Visibility.okToUseGui() in interface Visibility sample code for java.beans.Visibility definition code for java.beans.Visibility

avoidingGui sample code for java.beans.beancontext.BeanContextSupport.avoidingGui() definition code for java.beans.beancontext.BeanContextSupport.avoidingGui()

public boolean avoidingGui()
Used to determine if the BeanContext child is avoiding using its GUI.

Specified by:
avoidingGui sample code for java.beans.Visibility.avoidingGui() definition code for java.beans.Visibility.avoidingGui() in interface Visibility sample code for java.beans.Visibility definition code for java.beans.Visibility
Returns:
is this instance avoiding using its GUI?
See Also:
Visibility sample code for java.beans.Visibility definition code for java.beans.Visibility

isSerializing sample code for java.beans.beancontext.BeanContextSupport.isSerializing() definition code for java.beans.beancontext.BeanContextSupport.isSerializing()

public boolean isSerializing()
Is this BeanContext in the process of being serialized?

Returns:
if this BeanContext is currently being serialized

bcsChildren sample code for java.beans.beancontext.BeanContextSupport.bcsChildren() definition code for java.beans.beancontext.BeanContextSupport.bcsChildren()

protected Iterator sample code for java.util.Iterator definition code for java.util.Iterator  bcsChildren()
Returns an iterator of all children of this BeanContext.

Returns:
an iterator for all the current BCSChild values

bcsPreSerializationHook sample code for java.beans.beancontext.BeanContextSupport.bcsPreSerializationHook(java.io.ObjectOutputStream) definition code for java.beans.beancontext.BeanContextSupport.bcsPreSerializationHook(java.io.ObjectOutputStream)

protected void bcsPreSerializationHook(ObjectOutputStream sample code for java.io.ObjectOutputStream definition code for java.io.ObjectOutputStream  oos)
                                throws IOException sample code for java.io.IOException definition code for java.io.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().

Throws:
IOException sample code for java.io.IOException definition code for java.io.IOException

bcsPreDeserializationHook sample code for java.beans.beancontext.BeanContextSupport.bcsPreDeserializationHook(java.io.ObjectInputStream) definition code for java.beans.beancontext.BeanContextSupport.bcsPreDeserializationHook(java.io.ObjectInputStream)

protected void bcsPreDeserializationHook(ObjectInputStream sample code for java.io.ObjectInputStream definition code for java.io.ObjectInputStream  ois)
                                  throws IOException sample code for java.io.IOException definition code for java.io.IOException ,
                                         ClassNotFoundException sample code for java.lang.ClassNotFoundException definition code for java.lang.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().

Throws:
IOException sample code for java.io.IOException definition code for java.io.IOException
ClassNotFoundException sample code for java.lang.ClassNotFoundException definition code for java.lang.ClassNotFoundException

childDeserializedHook sample code for java.beans.beancontext.BeanContextSupport.childDeserializedHook(java.lang.Object, java.beans.beancontext.BeanContextSupport.BCSChild) definition code for java.beans.beancontext.BeanContextSupport.childDeserializedHook(java.lang.Object, java.beans.beancontext.BeanContextSupport.BCSChild)

protected void childDeserializedHook(Object sample code for java.lang.Object definition code for java.lang.Object  child,
                                     BeanContextSupport.BCSChild sample code for java.beans.beancontext.BeanContextSupport.BCSChild definition code for java.beans.beancontext.BeanContextSupport.BCSChild  bcsc)
Called by readObject with the newly deserialized child and BCSChild.

Parameters:
child - the newly deserialized child
bcsc - the newly deserialized BCSChild

serialize sample code for java.beans.beancontext.BeanContextSupport.serialize(java.io.ObjectOutputStream, java.util.Collection) definition code for java.beans.beancontext.BeanContextSupport.serialize(java.io.ObjectOutputStream, java.util.Collection)

protected final void serialize(ObjectOutputStream sample code for java.io.ObjectOutputStream definition code for java.io.ObjectOutputStream  oos,
                               Collection sample code for java.util.Collection definition code for java.util.Collection  coll)
                        throws IOException sample code for java.io.IOException definition code for java.io.IOException 
Used by writeObject to serialize a Collection.

Parameters:
oos - the ObjectOutputStream to use during serialization
coll - the Collection to serialize
Throws:
IOException sample code for java.io.IOException definition code for java.io.IOException - if serialization failed

deserialize sample code for java.beans.beancontext.BeanContextSupport.deserialize(java.io.ObjectInputStream, java.util.Collection) definition code for java.beans.beancontext.BeanContextSupport.deserialize(java.io.ObjectInputStream, java.util.Collection)

protected final void deserialize(ObjectInputStream sample code for java.io.ObjectInputStream definition code for java.io.ObjectInputStream  ois,
                                 Collection sample code for java.util.Collection definition code for java.util.Collection  coll)
                          throws IOException sample code for java.io.IOException definition code for java.io.IOException ,
                                 ClassNotFoundException sample code for java.lang.ClassNotFoundException definition code for java.lang.ClassNotFoundException 
used by readObject to deserialize a collection.

Parameters:
ois - the ObjectInputStream to use
coll - the Collection
Throws:
IOException sample code for java.io.IOException definition code for java.io.IOException
ClassNotFoundException sample code for java.lang.ClassNotFoundException definition code for java.lang.ClassNotFoundException

writeChildren sample code for java.beans.beancontext.BeanContextSupport.writeChildren(java.io.ObjectOutputStream) definition code for java.beans.beancontext.BeanContextSupport.writeChildren(java.io.ObjectOutputStream)

public final void writeChildren(ObjectOutputStream sample code for java.io.ObjectOutputStream definition code for java.io.ObjectOutputStream  oos)
                         throws IOException sample code for java.io.IOException definition code for java.io.IOException 
Used to serialize all children of this BeanContext.

Parameters:
oos - the ObjectOutputStream to use during serialization
Throws:
IOException sample code for java.io.IOException definition code for java.io.IOException - if serialization failed

readChildren sample code for java.beans.beancontext.BeanContextSupport.readChildren(java.io.ObjectInputStream) definition code for java.beans.beancontext.BeanContextSupport.readChildren(java.io.ObjectInputStream)

public final void readChildren(ObjectInputStream sample code for java.io.ObjectInputStream definition code for java.io.ObjectInputStream  ois)
                        throws IOException sample code for java.io.IOException definition code for java.io.IOException ,
                               ClassNotFoundException sample code for java.lang.ClassNotFoundException definition code for java.lang.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

Throws:
IOException sample code for java.io.IOException definition code for java.io.IOException
ClassNotFoundException sample code for java.lang.ClassNotFoundException definition code for java.lang.ClassNotFoundException

vetoableChange sample code for java.beans.beancontext.BeanContextSupport.vetoableChange(java.beans.PropertyChangeEvent) definition code for java.beans.beancontext.BeanContextSupport.vetoableChange(java.beans.PropertyChangeEvent)

public void vetoableChange(PropertyChangeEvent sample code for java.beans.PropertyChangeEvent definition code for java.beans.PropertyChangeEvent  pce)
                    throws PropertyVetoException sample code for java.beans.PropertyVetoException definition code for java.beans.PropertyVetoException 
subclasses may envelope to monitor veto child property changes.

Specified by:
vetoableChange sample code for java.beans.VetoableChangeListener.vetoableChange(java.beans.PropertyChangeEvent) definition code for java.beans.VetoableChangeListener.vetoableChange(java.beans.PropertyChangeEvent) in interface VetoableChangeListener sample code for java.beans.VetoableChangeListener definition code for java.beans.VetoableChangeListener
Parameters:
pce - a PropertyChangeEvent object describing the event source and the property that has changed.
Throws:
PropertyVetoException sample code for java.beans.PropertyVetoException definition code for java.beans.PropertyVetoException - if the recipient wishes the property change to be rolled back.

propertyChange sample code for java.beans.beancontext.BeanContextSupport.propertyChange(java.beans.PropertyChangeEvent) definition code for java.beans.beancontext.BeanContextSupport.propertyChange(java.beans.PropertyChangeEvent)

public void propertyChange(PropertyChangeEvent sample code for java.beans.PropertyChangeEvent definition code for java.beans.PropertyChangeEvent  pce)
subclasses may envelope to monitor child property changes.

Specified by:
propertyChange sample code for java.beans.PropertyChangeListener.propertyChange(java.beans.PropertyChangeEvent) definition code for java.beans.PropertyChangeListener.propertyChange(java.beans.PropertyChangeEvent) in interface PropertyChangeListener sample code for java.beans.PropertyChangeListener definition code for java.beans.PropertyChangeListener
Parameters:
pce - A PropertyChangeEvent object describing the event source and the property that has changed.

validatePendingAdd sample code for java.beans.beancontext.BeanContextSupport.validatePendingAdd(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.validatePendingAdd(java.lang.Object)

protected boolean validatePendingAdd(Object sample code for java.lang.Object definition code for java.lang.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.

Returns:
true iff the child may be added to this BeanContext, otherwise false.

validatePendingRemove sample code for java.beans.beancontext.BeanContextSupport.validatePendingRemove(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.validatePendingRemove(java.lang.Object)

protected boolean validatePendingRemove(Object sample code for java.lang.Object definition code for java.lang.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.

Returns:
true iff the child may be removed from this BeanContext, otherwise false.

childJustAddedHook sample code for java.beans.beancontext.BeanContextSupport.childJustAddedHook(java.lang.Object, java.beans.beancontext.BeanContextSupport.BCSChild) definition code for java.beans.beancontext.BeanContextSupport.childJustAddedHook(java.lang.Object, java.beans.beancontext.BeanContextSupport.BCSChild)

protected void childJustAddedHook(Object sample code for java.lang.Object definition code for java.lang.Object  child,
                                  BeanContextSupport.BCSChild sample code for java.beans.beancontext.BeanContextSupport.BCSChild definition code for java.beans.beancontext.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.


childJustRemovedHook sample code for java.beans.beancontext.BeanContextSupport.childJustRemovedHook(java.lang.Object, java.beans.beancontext.BeanContextSupport.BCSChild) definition code for java.beans.beancontext.BeanContextSupport.childJustRemovedHook(java.lang.Object, java.beans.beancontext.BeanContextSupport.BCSChild)

protected void childJustRemovedHook(Object sample code for java.lang.Object definition code for java.lang.Object  child,
                                    BeanContextSupport.BCSChild sample code for java.beans.beancontext.BeanContextSupport.BCSChild definition code for java.beans.beancontext.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.


getChildVisibility sample code for java.beans.beancontext.BeanContextSupport.getChildVisibility(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.getChildVisibility(java.lang.Object)

protected static final Visibility sample code for java.beans.Visibility definition code for java.beans.Visibility  getChildVisibility(Object sample code for java.lang.Object definition code for java.lang.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.

getChildSerializable sample code for java.beans.beancontext.BeanContextSupport.getChildSerializable(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.getChildSerializable(java.lang.Object)

protected static final Serializable sample code for java.io.Serializable definition code for java.io.Serializable  getChildSerializable(Object sample code for java.lang.Object definition code for java.lang.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

getChildPropertyChangeListener sample code for java.beans.beancontext.BeanContextSupport.getChildPropertyChangeListener(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.getChildPropertyChangeListener(java.lang.Object)

protected static final PropertyChangeListener sample code for java.beans.PropertyChangeListener definition code for java.beans.PropertyChangeListener  getChildPropertyChangeListener(Object sample code for java.lang.Object definition code for java.lang.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

getChildVetoableChangeListener sample code for java.beans.beancontext.BeanContextSupport.getChildVetoableChangeListener(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.getChildVetoableChangeListener(java.lang.Object)

protected static final VetoableChangeListener sample code for java.beans.VetoableChangeListener definition code for java.beans.VetoableChangeListener  getChildVetoableChangeListener(Object sample code for java.lang.Object definition code for java.lang.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

getChildBeanContextMembershipListener sample code for java.beans.beancontext.BeanContextSupport.getChildBeanContextMembershipListener(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.getChildBeanContextMembershipListener(java.lang.Object)

protected static final BeanContextMembershipListener sample code for java.beans.beancontext.BeanContextMembershipListener definition code for java.beans.beancontext.BeanContextMembershipListener  getChildBeanContextMembershipListener(Object sample code for java.lang.Object definition code for java.lang.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

getChildBeanContextChild sample code for java.beans.beancontext.BeanContextSupport.getChildBeanContextChild(java.lang.Object) definition code for java.beans.beancontext.BeanContextSupport.getChildBeanContextChild(java.lang.Object)

protected static final BeanContextChild sample code for java.beans.beancontext.BeanContextChild definition code for java.beans.beancontext.BeanContextChild  getChildBeanContextChild(Object sample code for java.lang.Object definition code for java.lang.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 sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if child implements both BeanContextChild and BeanContextProxy

fireChildrenAdded sample code for java.beans.beancontext.BeanContextSupport.fireChildrenAdded(java.beans.beancontext.BeanContextMembershipEvent) definition code for java.beans.beancontext.BeanContextSupport.fireChildrenAdded(java.beans.beancontext.BeanContextMembershipEvent)

protected final void fireChildrenAdded(BeanContextMembershipEvent sample code for java.beans.beancontext.BeanContextMembershipEvent definition code for java.beans.beancontext.BeanContextMembershipEvent  bcme)
Fire a BeanContextshipEvent on the BeanContextMembershipListener interface


fireChildrenRemoved sample code for java.beans.beancontext.BeanContextSupport.fireChildrenRemoved(java.beans.beancontext.BeanContextMembershipEvent) definition code for java.beans.beancontext.BeanContextSupport.fireChildrenRemoved(java.beans.beancontext.BeanContextMembershipEvent)

protected final void fireChildrenRemoved(BeanContextMembershipEvent sample code for java.beans.beancontext.BeanContextMembershipEvent definition code for java.beans.beancontext.BeanContextMembershipEvent  bcme)
Fire a BeanContextshipEvent on the BeanContextMembershipListener interface


initialize sample code for java.beans.beancontext.BeanContextSupport.initialize() definition code for java.beans.beancontext.BeanContextSupport.initialize()

protected 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


copyChildren sample code for java.beans.beancontext.BeanContextSupport.copyChildren() definition code for java.beans.beancontext.BeanContextSupport.copyChildren()

protected final Object sample code for java.lang.Object definition code for java.lang.Object [] copyChildren()
Gets a copy of the this BeanContext's children.

Returns:
a copy of the current nested children

classEquals sample code for java.beans.beancontext.BeanContextSupport.classEquals(java.lang.Class, java.lang.Class) definition code for java.beans.beancontext.BeanContextSupport.classEquals(java.lang.Class, java.lang.Class)

protected static final boolean classEquals(Class sample code for java.lang.Class definition code for java.lang.Class  first,
                                           Class sample code for java.lang.Class definition code for java.lang.Class  second)
Tests to see if two class objects, or their names are equal.

Parameters:
first - the first object
second - the second object
Returns:
true if equal, false if not