< 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 >