java.beans.beancontext

Interface BeanContext

All Superinterfaces:
BeanContextChild, Collection<E>, DesignMode, Iterable<T>, Visibility
Known Subinterfaces:
BeanContextServices
Known Implementing Classes:
BeanContextServicesSupport, BeanContextSupport

public interface BeanContext
extends BeanContextChild, Collection<E>, DesignMode, Visibility

The BeanContext acts a logical hierarchical container for JavaBeans.
Since:
1.2
See Also:
Beans, BeanContextChild, BeanContextMembershipListener, PropertyChangeEvent, java.beans.VetoableChangeEvent, DesignMode, Visibility, Collection

Field Summary

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

Fields inherited from interface java.beans.DesignMode

PROPERTYNAME

Method Summary

void
addBeanContextMembershipListener(BeanContextMembershipListener bcml)
Adds the specified BeanContextMembershipListener to receive BeanContextMembershipEvents from this BeanContext whenever it adds or removes a child Component(s).
URL
getResource(String name, BeanContextChild bcc)
Analagous to java.lang.ClassLoader.getResource(), this method allows a BeanContext implementation to interpose behavior between the child Component and underlying ClassLoader.
InputStream
getResourceAsStream(String name, BeanContextChild bcc)
Analagous to java.lang.ClassLoader.getResourceAsStream(), this method allows a BeanContext implementation to interpose behavior between the child Component and underlying ClassLoader.
Object
instantiateChild(String beanName)
Instantiate the javaBean named as a child of this BeanContext.
void
removeBeanContextMembershipListener(BeanContextMembershipListener bcml)
Removes the specified BeanContextMembershipListener so that it no longer receives BeanContextMembershipEvents when the child Component(s) are added or removed.

Methods inherited from interface java.beans.beancontext.BeanContextChild

addPropertyChangeListener, addVetoableChangeListener, getBeanContext, removePropertyChangeListener, removeVetoableChangeListener, setBeanContext

Methods inherited from interface java.util.Collection<E>

T[] toArray, add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray

Methods inherited from interface java.beans.DesignMode

isDesignTime, setDesignTime

Methods inherited from interface java.lang.Iterable<T>

iterator

Methods inherited from interface java.beans.Visibility

avoidingGui, dontUseGui, needsGui, okToUseGui

Field Details

globalHierarchyLock

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

addBeanContextMembershipListener

public 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
Usages and Demos :

View More Examples of addBeanContextMembershipListener(BeanContextMembershipListener bcml)
   1: 
   2: import java.beans.beancontext.*;
   3: import java.beans.*;
   4:         ...
   5: 
   6:   public void setBeanContext(BeanContext in_bc)
   7:     throws PropertyVetoException {
   8:         ...
   9:     if (in_bc != null) {
  10:       in_bc.addBeanContextMembershipListener(this);
  11:       beanContextChildSupport.setBeanContext(in_bc);

View Full Code Here

getResource

public 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

getResourceAsStream

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

instantiateChild

public 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

removeBeanContextMembershipListener

public 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