java.beans.beancontext
Interface BeanContext
-
- 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
All Methods Instance Methods Abstract 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, parallelStream, remove, removeAll, removeIf, retainAll, size, spliterator, stream, 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
- Returns:
-
a javaBean named as a child of this
BeanContext
- Throws:
-
IOException
- if an IO problem occurs -
ClassNotFoundException
- 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 aBeanContext
implementation to interpose behavior between the childComponent
and underlyingClassLoader
.- Parameters:
-
name
- the resource name -
bcc
- the specified child - Returns:
-
an
InputStream
for reading the resource, ornull
if 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 aBeanContext
implementation to interpose behavior between the childComponent
and underlyingClassLoader
.- Parameters:
-
name
- the resource name -
bcc
- the specified child - Returns:
-
a
URL
for the named resource for the specified child - Throws:
-
IllegalArgumentException
- if the resource is not valid
addBeanContextMembershipListener
void addBeanContextMembershipListener(BeanContextMembershipListener bcml)
Adds the specifiedBeanContextMembershipListener
to receiveBeanContextMembershipEvents
from thisBeanContext
whenever it adds or removes a childComponent
(s).- Parameters:
-
bcml
- the BeanContextMembershipListener 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
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.