< prev index next >

src/java.desktop/share/classes/java/beans/beancontext/BeanContext.java

Print this page

        

*** 56,135 **** @SuppressWarnings("rawtypes") 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. * * @return a javaBean named as a child of this ! * <code>BeanContext</code> * @param beanName The name of the JavaBean to instantiate ! * as a child of this <code>BeanContext</code> * @throws IOException if an IO problem occurs * @throws ClassNotFoundException 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 IllegalArgumentException 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 IllegalArgumentException * 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 BeanContextMembershipListener 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(); } --- 56,135 ---- @SuppressWarnings("rawtypes") public interface BeanContext extends BeanContextChild, Collection, DesignMode, Visibility { /** * Instantiate the javaBean named as a ! * child of this {@code BeanContext}. * The implementation of the JavaBean is * derived from the value of the beanName parameter, * and is defined by the ! * {@code java.beans.Beans.instantiate()} method. * * @return a javaBean named as a child of this ! * {@code BeanContext} * @param beanName The name of the JavaBean to instantiate ! * as a child of this {@code BeanContext} * @throws IOException if an IO problem occurs * @throws ClassNotFoundException 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()}, ! * this method allows a {@code BeanContext} implementation ! * to interpose behavior between the child {@code Component} ! * and underlying {@code ClassLoader}. * * @param name the resource name * @param bcc the specified child ! * @return an {@code InputStream} for reading the resource, ! * or {@code null} if the resource could not * be found. * @throws IllegalArgumentException if * the resource is not valid */ InputStream getResourceAsStream(String name, BeanContextChild bcc) throws IllegalArgumentException; /** ! * Analagous to {@code java.lang.ClassLoader.getResource()}, this ! * method allows a {@code BeanContext} implementation to interpose ! * behavior between the child {@code Component} ! * and underlying {@code ClassLoader}. * * @param name the resource name * @param bcc the specified child ! * @return a {@code URL} for the named * resource for the specified child * @throws IllegalArgumentException * if the resource is not valid */ URL getResource(String name, BeanContextChild bcc) throws IllegalArgumentException; /** ! * Adds the specified {@code BeanContextMembershipListener} ! * to receive {@code BeanContextMembershipEvents} from ! * this {@code BeanContext} whenever it adds ! * or removes a child {@code Component}(s). * * @param bcml the BeanContextMembershipListener to be added */ void addBeanContextMembershipListener(BeanContextMembershipListener bcml); /** ! * Removes the specified {@code BeanContextMembershipListener} ! * so that it no longer receives {@code BeanContextMembershipEvent}s ! * when the child {@code Component}(s) are added or removed. * ! * @param bcml the {@code BeanContextMembershipListener} * to be removed */ void removeBeanContextMembershipListener(BeanContextMembershipListener bcml); /** ! * This global lock is used by both {@code BeanContext} ! * and {@code BeanContextServices} implementors ! * to serialize changes in a {@code BeanContext} * hierarchy and any service requests etc. */ public static final Object globalHierarchyLock = new Object(); }
< prev index next >