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
Fields
globalHierarchyLock
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.
Methods
instantiateChild
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 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 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, 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 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 - Throws:
-
IllegalArgumentException
- if the resource is not valid
addBeanContextMembershipListener
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
removeBeanContextMembershipListener
void removeBeanContextMembershipListener(BeanContextMembershipListener bcml)
Removes the specified BeanContextMembershipListener
so that it no longer receives BeanContextMembershipEvent
s when the child Component
(s) are added or removed.
- Parameters:
-
bcml
- theBeanContextMembershipListener
to be removed
© 1993–2017, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.