-
- 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 Object
globalHierarchyLock
This global lock is used by bothBeanContext
andBeanContextServices
implementors to serialize changes in aBeanContext
hierarchy and any service requests etc.-
Fields inherited from interface java.beans.DesignMode
PROPERTYNAME
-
-
Method Summary
Methods Modifier and Type Method and Description void
addBeanContextMembershipListener(BeanContextMembershipListener bcml)
Adds the specifiedBeanContextMembershipListener
to receiveBeanContextMembershipEvents
from thisBeanContext
whenever it adds or removes a childComponent
(s).URL
getResource(String name, BeanContextChild bcc)
Analagous tojava.lang.ClassLoader.getResource()
, this method allows aBeanContext
implementation to interpose behavior between the childComponent
and underlyingClassLoader
.InputStream
getResourceAsStream(String name, BeanContextChild bcc)
Analagous tojava.lang.ClassLoader.getResourceAsStream()
, this method allows aBeanContext
implementation to interpose behavior between the childComponent
and underlyingClassLoader
.Object
instantiateChild(String beanName)
Instantiate the javaBean named as a child of thisBeanContext
.void
removeBeanContextMembershipListener(BeanContextMembershipListener bcml)
Removes the specifiedBeanContextMembershipListener
so that it no longer receivesBeanContextMembershipEvent
s 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 bothBeanContext
andBeanContextServices
implementors to serialize changes in aBeanContext
hierarchy 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 foundClassNotFoundException
IOException
ClassNotFoundException
-
getResourceAsStream
InputStream getResourceAsStream(String name, BeanContextChild bcc) throws IllegalArgumentException
Analagous tojava.lang.ClassLoader.getResourceAsStream()
, this method allows aBeanContext
implementation to interpose behavior between the childComponent
and underlyingClassLoader
.- Parameters:
name
- the resource namebcc
- the specified child- Returns:
- an
InputStream
for reading the resource, ornull
if the resource could not be found. - Throws:
- if the resource is not validIllegalArgumentException
IllegalArgumentException
-
getResource
URL getResource(String name, BeanContextChild bcc) throws IllegalArgumentException
Analagous tojava.lang.ClassLoader.getResource()
, this method allows aBeanContext
implementation to interpose behavior between the childComponent
and underlyingClassLoader
.- Parameters:
name
- the resource namebcc
- the specified child- Returns:
- a
URL
for the named resource for the specified child - Throws:
- if the resource is not validIllegalArgumentException
IllegalArgumentException
-
addBeanContextMembershipListener
void addBeanContextMembershipListener(BeanContextMembershipListener bcml)
Adds the specifiedBeanContextMembershipListener
to receiveBeanContextMembershipEvents
from thisBeanContext
whenever it adds or removes a childComponent
(s).- Parameters:
bcml
- theBeanContextMembershipListener
to be added
-
removeBeanContextMembershipListener
void removeBeanContextMembershipListener(BeanContextMembershipListener bcml)
Removes the specifiedBeanContextMembershipListener
so that it no longer receivesBeanContextMembershipEvent
s when the childComponent
(s) are added or removed.- Parameters:
bcml
- theBeanContextMembershipListener
to 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 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.