-
- All Superinterfaces:
BeanContextChild,Collection,DesignMode,Iterable,Visibility
- All Known Subinterfaces:
BeanContextServices
- All Known Implementing Classes:
BeanContextServicesSupport,BeanContextSupport
public interface BeanContext extends BeanContextChild, Collection, DesignMode, Visibility
The BeanContext acts a logical hierarchical container for JavaBeans.
- Since:
- 1.2
- See Also:
Beans,BeanContextChild,BeanContextMembershipListener,PropertyChangeEvent,DesignMode,Visibility,Collection
-
-
Field Summary
Fields Modifier and Type Field Description static ObjectglobalHierarchyLockThis global lock is used by bothBeanContextandBeanContextServicesimplementors to serialize changes in aBeanContexthierarchy and any service requests etc.-
Fields declared in interface java.beans.DesignMode
PROPERTYNAME
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description voidaddBeanContextMembershipListener(BeanContextMembershipListener bcml)Adds the specifiedBeanContextMembershipListenerto receiveBeanContextMembershipEventsfrom thisBeanContextwhenever it adds or removes a childComponent(s).URLgetResource(String name, BeanContextChild bcc)Analagous tojava.lang.ClassLoader.getResource(), this method allows aBeanContextimplementation to interpose behavior between the childComponentand underlyingClassLoader.InputStreamgetResourceAsStream(String name, BeanContextChild bcc)Analagous tojava.lang.ClassLoader.getResourceAsStream(), this method allows aBeanContextimplementation to interpose behavior between the childComponentand underlyingClassLoader.ObjectinstantiateChild(String beanName)Instantiate the javaBean named as a child of thisBeanContext.voidremoveBeanContextMembershipListener(BeanContextMembershipListener bcml)Removes the specifiedBeanContextMembershipListenerso that it no longer receivesBeanContextMembershipEvents when the childComponent(s) are added or removed.-
Methods declared in interface java.beans.beancontext.BeanContextChild
addPropertyChangeListener, addVetoableChangeListener, getBeanContext, removePropertyChangeListener, removeVetoableChangeListener, setBeanContext
-
Methods declared in interface java.util.Collection
add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, parallelStream, remove, removeAll, removeIf, retainAll, size, spliterator, stream, toArray, toArray, toArray
-
Methods declared in interface java.beans.DesignMode
isDesignTime, setDesignTime
-
Methods declared in interface java.beans.Visibility
avoidingGui, dontUseGui, needsGui, okToUseGui
-
-
-
-
Field Detail
-
globalHierarchyLock
static final Object globalHierarchyLock
This global lock is used by bothBeanContextandBeanContextServicesimplementors to serialize changes in aBeanContexthierarchy and any service requests etc.
-
-
Method Detail
-
instantiateChild
Object instantiateChild(String beanName) throws IOException, ClassNotFoundException
Instantiate the javaBean named as a child of thisBeanContext. The implementation of the JavaBean is derived from the value of the beanName parameter, and is defined by thejava.beans.Beans.instantiate()method.- Parameters:
beanName- The name of the JavaBean to instantiate as a child of thisBeanContext- Returns:
- a javaBean named as a child of this
BeanContext - Throws:
IOException- if an IO problem occursClassNotFoundException- if the class identified by the beanName parameter is not found
-
getResourceAsStream
InputStream getResourceAsStream(String name, BeanContextChild bcc) throws IllegalArgumentException
Analagous tojava.lang.ClassLoader.getResourceAsStream(), this method allows aBeanContextimplementation to interpose behavior between the childComponentand underlyingClassLoader.- Parameters:
name- the resource namebcc- the specified child- Returns:
- an
InputStreamfor reading the resource, ornullif the resource could not be found. - Throws:
IllegalArgumentException- if the resource is not valid
-
getResource
URL getResource(String name, BeanContextChild bcc) throws IllegalArgumentException
Analagous tojava.lang.ClassLoader.getResource(), this method allows aBeanContextimplementation to interpose behavior between the childComponentand underlyingClassLoader.- Parameters:
name- the resource namebcc- the specified child- Returns:
- a
URLfor the named resource for the specified child - Throws:
IllegalArgumentException- if the resource is not valid
-
addBeanContextMembershipListener
void addBeanContextMembershipListener(BeanContextMembershipListener bcml)
Adds the specifiedBeanContextMembershipListenerto receiveBeanContextMembershipEventsfrom thisBeanContextwhenever it adds or removes a childComponent(s).- Parameters:
bcml- the BeanContextMembershipListener to be added
-
removeBeanContextMembershipListener
void removeBeanContextMembershipListener(BeanContextMembershipListener bcml)
Removes the specifiedBeanContextMembershipListenerso that it no longer receivesBeanContextMembershipEvents when the childComponent(s) are added or removed.- Parameters:
bcml- theBeanContextMembershipListenerto be removed
-
-