1. /*

  2.  * @(#)BeanContext.java	1.14 01/11/29

  3.  *

  4.  * Copyright 2002 Sun Microsystems, Inc. All rights reserved.

  5.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  6.  */

  7. 

  8. package java.beans.beancontext;

  9. 

  10. import java.beans.DesignMode;

  11. import java.beans.Visibility;

  12. 

  13. import java.io.InputStream;

  14. import java.io.IOException;

  15. 

  16. import java.net.URL;

  17. 

  18. import java.util.Collection;

  19. import java.util.Locale;

  20. 

  21. /**

  22.  * <p>

  23.  * The BeanContext acts a logical heirarchical container for JavaBeans.

  24.  * </p>

  25.  *

  26.  * @author Laurence P. G. Cable

  27.  * @version 1.9

  28.  * @since JDK1.2

  29.  *

  30.  * @seealso java.beans.Beans

  31.  * @seealso java.beans.beancontext.BeanContextChild

  32.  * @seealso java.beans.beancontext.BeanContextListener

  33.  * @seealso java.beans.PropertyChangeEvent

  34.  * @seealso java.beans.VetoableChangeEvent

  35.  * @seealso java.beans.DesignMode

  36.  * @seealso java.beans.Visibility

  37.  * @seealso java.util.Collection

  38.  */

  39. 

  40. public interface BeanContext extends BeanContextChild, Collection, DesignMode, Visibility {

  41. 

  42.     /**

  43.      * Instantiate the javaBean named as a child of this BeanContext

  44.      *

  45.      * @param beanName The name of the JavaBean to instantiate as a child of this BeanContext

  46.      */

  47. 

  48.     Object instantiateChild(String beanName) throws IOException, ClassNotFoundException;

  49. 

  50.     /**

  51.      * @return an InputStream to the named resource for the specified child

  52.      *

  53.      * @throw IllegalArgumentException

  54.      */

  55. 

  56.     InputStream getResourceAsStream(String name, BeanContextChild bcc) throws IllegalArgumentException;

  57. 

  58.     /**

  59.      * @return a URL for the named resource for the specified child

  60.      *

  61.      * @throw IllegalArgumentException

  62.      */

  63. 

  64.     URL getResource(String name, BeanContextChild bcc) throws IllegalArgumentException;

  65. 

  66.      /**

  67.       * add a BeanContextMembershipListener

  68.       */

  69. 

  70.     void addBeanContextMembershipListener(BeanContextMembershipListener bcml);

  71. 

  72.      /**

  73.       * remove a BeanContextMembershipListener

  74.       */

  75. 

  76.     void removeBeanContextMembershipListener(BeanContextMembershipListener bcml);

  77. 

  78.     /**

  79.      * this global lock is used by both BeanContext and BeanContextServices

  80.      * implementors to serialize changes in a BeanContext hierarchy and

  81.      * any service requests etc.

  82.      */

  83. 

  84.     public static final Object globalHierarchyLock = new Object();

  85. }