FileDocCategorySizeDatePackage
BeanContext.javaAPI DocJava SE 5 API4145Fri Aug 26 14:56:58 BST 2005java.beans.beancontext

BeanContext

public interface BeanContext implements Collection, Visibility, DesignMode, BeanContextChild

The BeanContext acts a logical hierarchical container for JavaBeans.

author
Laurence P. G. Cable
version
1.23, 12/19/03
since
1.2
see
java.beans.Beans
see
java.beans.beancontext.BeanContextChild
see
java.beans.beancontext.BeanContextMembershipListener
see
java.beans.PropertyChangeEvent
see
java.beans.VetoableChangeEvent
see
java.beans.DesignMode
see
java.beans.Visibility
see
java.util.Collection

Fields Summary
public static final Object
globalHierarchyLock
This global lock is used by both BeanContext and BeanContextServices implementors to serialize changes in a BeanContext hierarchy and any service requests etc.
Constructors Summary
Methods Summary
public voidaddBeanContextMembershipListener(java.beans.beancontext.BeanContextMembershipListener bcml)
Adds the specified BeanContextMembershipListener to receive BeanContextMembershipEvents from this BeanContext whenever it adds or removes a child Component(s).

param
bcml the BeanContextMembershipListener to be added

public java.net.URLgetResource(java.lang.String name, 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.

param
name the resource name
param
bcc the specified child
return
a URL for the named resource for the specified child
throws
IllegalArgumentException if the resource is not valid

public java.io.InputStreamgetResourceAsStream(java.lang.String name, 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.

param
name the resource name
param
bcc the specified child
return
an InputStream for reading the resource, or null if the resource could not be found.
throws
IllegalArgumentException if the resource is not valid

public java.lang.ObjectinstantiateChild(java.lang.String beanName)
Instantiate the javaBean named as a child of this BeanContext. The implementation of the JavaBean is derived from the value of the beanName parameter, and is defined by the java.beans.Beans.instantiate() method.

param
beanName The name of the JavaBean to instantiate as a child of this BeanContext
throws
IOException
throws
ClassNotFoundException if the class identified by the beanName parameter is not found

public voidremoveBeanContextMembershipListener(java.beans.beancontext.BeanContextMembershipListener bcml)
Removes the specified BeanContextMembershipListener so that it no longer receives BeanContextMembershipEvents when the child Component(s) are added or removed.

param
bcml the BeanContextMembershipListener to be removed