/* * Copyright (c) 1997, 2006, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation.  Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package java.beans.beancontext; import java.beans.DesignMode;import java.beans.Visibility; import java.io.InputStream;import java.io.IOException; import java.net.URL; import java.util.Collection;import java.util.Locale; /** * <p> * The BeanContext acts a logical hierarchical container for JavaBeans. * </p> * * @author Laurence P. G. Cable * @since 1.2 * * @see java.beans.Beans * @see java.beans.beancontext.BeanContextChild * @see java.beans.beancontext.BeanContextMembershipListener * @see java.beans.PropertyChangeEvent * @see java.beans.DesignMode * @see java.beans.Visibility * @see java.util.Collection */ public interface BeanContext extends BeanContextChild, Collection, DesignMode, Visibility {     /**     * Instantiate the javaBean named as a     * child of this <code>BeanContext</code>.     * The implementation of the JavaBean is     * derived from the value of the beanName parameter,     * and is defined by the     * <code>java.beans.Beans.instantiate()</code> method.     *     * @param beanName The name of the JavaBean to instantiate     * as a child of this <code>BeanContext</code>     * @throws <code>IOException</code>     * @throws <code>ClassNotFoundException</code> if the class identified     * by the beanName parameter is not found     */    Object instantiateChild(String beanName) throws IOException, ClassNotFoundException;     /**     * Analagous to <code>java.lang.ClassLoader.getResourceAsStream()</code>,     * this method allows a <code>BeanContext</code> implementation     * to interpose behavior between the child <code>Component</code>     * and underlying <code>ClassLoader</code>.     *     * @param name the resource name     * @param bcc the specified child     * @return an <code>InputStream</code> for reading the resource,     * or <code>null</code> if the resource could not     * be found.     * @throws <code>IllegalArgumentException</code> if     * the resource is not valid     */    InputStream getResourceAsStream(String name, BeanContextChild bcc) throws IllegalArgumentException;     /**     * Analagous to <code>java.lang.ClassLoader.getResource()</code>, this     * method allows a <code>BeanContext</code> implementation to interpose     * behavior between the child <code>Component</code>     * and underlying <code>ClassLoader</code>.     *     * @param name the resource name     * @param bcc the specified child     * @return a <code>URL</code> for the named     * resource for the specified child     * @throws <code>IllegalArgumentException</code>     * if the resource is not valid     */    URL getResource(String name, BeanContextChild bcc) throws IllegalArgumentException;      /**      * Adds the specified <code>BeanContextMembershipListener</code>      * to receive <code>BeanContextMembershipEvents</code> from      * this <code>BeanContext</code> whenever it adds      * or removes a child <code>Component</code>(s).      *      * @param bcml the <code>BeanContextMembershipListener</code> to be added      */    void addBeanContextMembershipListener(BeanContextMembershipListener bcml);      /**      * Removes the specified <code>BeanContextMembershipListener</code>      * so that it no longer receives <code>BeanContextMembershipEvent</code>s      * when the child <code>Component</code>(s) are added or removed.      *      * @param bcml the <code>BeanContextMembershipListener</code>      * to be removed      */    void removeBeanContextMembershipListener(BeanContextMembershipListener bcml);     /**     * This global lock is used by both <code>BeanContext</code>     * and <code>BeanContextServices</code> implementors     * to serialize changes in a <code>BeanContext</code>     * hierarchy and any service requests etc.     */    public static final Object globalHierarchyLock = new Object();}