-
- 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 and Description static ObjectglobalHierarchyLockThis global lock is used by bothBeanContextandBeanContextServicesimplementors to serialize changes in aBeanContexthierarchy and any service requests etc.-
Fields inherited from interface java.beans.DesignMode
PROPERTYNAME
-
-
Method Summary
Methods Modifier and Type Method and 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 inherited from interface java.beans.beancontext.BeanContextChild
addPropertyChangeListener, addVetoableChangeListener, getBeanContext, removePropertyChangeListener, removeVetoableChangeListener, setBeanContext
-
Methods inherited from interface java.util.Collection
add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray
-
Methods inherited from interface java.beans.DesignMode
isDesignTime, setDesignTime
-
Methods inherited from 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- Throws:
IOException- if the class identified by the beanName parameter is not foundClassNotFoundExceptionIOExceptionClassNotFoundException
-
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:
- if the resource is not validIllegalArgumentExceptionIllegalArgumentException
-
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:
- if the resource is not validIllegalArgumentExceptionIllegalArgumentException
-
addBeanContextMembershipListener
void addBeanContextMembershipListener(BeanContextMembershipListener bcml)
Adds the specifiedBeanContextMembershipListenerto receiveBeanContextMembershipEventsfrom thisBeanContextwhenever it adds or removes a childComponent(s).- Parameters:
bcml- theBeanContextMembershipListenerto 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
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-java/beans/beancontext/beancontext.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author of this site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.