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

  Throws:

  IOException

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

  IOException

  ClassNotFoundException

• 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

  IllegalArgumentException

• 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

  IllegalArgumentException

• 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