Field Detail

• globalHierarchyLock

  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.

Method Detail

• instantiateChild

  Object instantiateChild(String beanName)
                   throws IOException,
                          ClassNotFoundException

  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.

  Parameters:

  beanName - The name of the JavaBean to instantiate as a child of this BeanContext

  Returns:

  a javaBean named as a child of this BeanContext

  Throws:

  IOException - if an IO problem occurs

  ClassNotFoundException - if the class identified by the beanName parameter is not found

• getResourceAsStream

  InputStream getResourceAsStream(String name,
                                  BeanContextChild bcc)
                           throws IllegalArgumentException

  Analagous to java.lang.ClassLoader.getResourceAsStream(), this method allows a BeanContext implementation to interpose behavior between the child Component and underlying ClassLoader.

  Parameters:

  name - the resource name

  bcc - the specified child

  Returns:

  an InputStream for reading the resource, or null if the resource could not be found.

  Throws:

  IllegalArgumentException - if the resource is not valid

• getResource

  URL getResource(String name,
                  BeanContextChild bcc)
           throws IllegalArgumentException

  Analagous to java.lang.ClassLoader.getResource(), this method allows a BeanContext implementation to interpose behavior between the child Component and underlying ClassLoader.

  Parameters:

  name - the resource name

  bcc - the specified child

  Returns:

  a URL for the named resource for the specified child

  Throws:

  IllegalArgumentException - if the resource is not valid

• addBeanContextMembershipListener

  void addBeanContextMembershipListener(BeanContextMembershipListener bcml)

  Adds the specified BeanContextMembershipListener to receive BeanContextMembershipEvents from this BeanContext whenever it adds or removes a child Component(s).

  Parameters:

  bcml - the BeanContextMembershipListener to be added

• removeBeanContextMembershipListener

  void removeBeanContextMembershipListener(BeanContextMembershipListener bcml)

  Removes the specified BeanContextMembershipListener so that it no longer receives BeanContextMembershipEvents when the child Component(s) are added or removed.

  Parameters:

  bcml - the BeanContextMembershipListener to be removed