BeanContext (Java Platform SE 8 ) (original) (raw)

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 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.

   * ### Fields inherited from interface java.beans.[DesignMode](../../../java/beans/DesignMode.html "interface in java.beans")  
   `[PROPERTYNAME](../../../java/beans/DesignMode.html#PROPERTYNAME)`

Method Summary

All Methods Instance Methods Abstract Methods

Modifier and Type	Method	Description
void	addBeanContextMembershipListener(BeanContextMembershipListener bcml)	Adds the specified BeanContextMembershipListener to receive BeanContextMembershipEvents from this BeanContext whenever it adds or removes a child Component(s).
URL	getResource(String name,BeanContextChild bcc)	Analagous to java.lang.ClassLoader.getResource(), this method allows a BeanContext implementation to interpose behavior between the child Component and underlying ClassLoader.
InputStream	getResourceAsStream(String name,BeanContextChild bcc)	Analagous to java.lang.ClassLoader.getResourceAsStream(), this method allows a BeanContext implementation to interpose behavior between the child Component and underlying ClassLoader.
Object	instantiateChild(String beanName)	Instantiate the javaBean named as a child of this BeanContext.
void	removeBeanContextMembershipListener(BeanContextMembershipListener bcml)	Removes the specified BeanContextMembershipListener so that it no longer receives BeanContextMembershipEvents when the child Component(s) are added or removed.

   * ### Methods inherited from interface java.beans.beancontext.[BeanContextChild](../../../java/beans/beancontext/BeanContextChild.html "interface in java.beans.beancontext")  
   `[addPropertyChangeListener](../../../java/beans/beancontext/BeanContextChild.html#addPropertyChangeListener-java.lang.String-java.beans.PropertyChangeListener-), [addVetoableChangeListener](../../../java/beans/beancontext/BeanContextChild.html#addVetoableChangeListener-java.lang.String-java.beans.VetoableChangeListener-), [getBeanContext](../../../java/beans/beancontext/BeanContextChild.html#getBeanContext--), [removePropertyChangeListener](../../../java/beans/beancontext/BeanContextChild.html#removePropertyChangeListener-java.lang.String-java.beans.PropertyChangeListener-), [removeVetoableChangeListener](../../../java/beans/beancontext/BeanContextChild.html#removeVetoableChangeListener-java.lang.String-java.beans.VetoableChangeListener-), [setBeanContext](../../../java/beans/beancontext/BeanContextChild.html#setBeanContext-java.beans.beancontext.BeanContext-)`  
   * ### Methods inherited from interface java.util.[Collection](../../../java/util/Collection.html "interface in java.util")  
   `[add](../../../java/util/Collection.html#add-E-), [addAll](../../../java/util/Collection.html#addAll-java.util.Collection-), [clear](../../../java/util/Collection.html#clear--), [contains](../../../java/util/Collection.html#contains-java.lang.Object-), [containsAll](../../../java/util/Collection.html#containsAll-java.util.Collection-), [equals](../../../java/util/Collection.html#equals-java.lang.Object-), [hashCode](../../../java/util/Collection.html#hashCode--), [isEmpty](../../../java/util/Collection.html#isEmpty--), [iterator](../../../java/util/Collection.html#iterator--), [parallelStream](../../../java/util/Collection.html#parallelStream--), [remove](../../../java/util/Collection.html#remove-java.lang.Object-), [removeAll](../../../java/util/Collection.html#removeAll-java.util.Collection-), [removeIf](../../../java/util/Collection.html#removeIf-java.util.function.Predicate-), [retainAll](../../../java/util/Collection.html#retainAll-java.util.Collection-), [size](../../../java/util/Collection.html#size--), [spliterator](../../../java/util/Collection.html#spliterator--), [stream](../../../java/util/Collection.html#stream--), [toArray](../../../java/util/Collection.html#toArray--), [toArray](../../../java/util/Collection.html#toArray-T:A-)`  
   * ### Methods inherited from interface java.lang.[Iterable](../../../java/lang/Iterable.html "interface in java.lang")  
   `[forEach](../../../java/lang/Iterable.html#forEach-java.util.function.Consumer-)`  
   * ### Methods inherited from interface java.beans.[DesignMode](../../../java/beans/DesignMode.html "interface in java.beans")  
   `[isDesignTime](../../../java/beans/DesignMode.html#isDesignTime--), [setDesignTime](../../../java/beans/DesignMode.html#setDesignTime-boolean-)`  
   * ### Methods inherited from interface java.beans.[Visibility](../../../java/beans/Visibility.html "interface in java.beans")  
   `[avoidingGui](../../../java/beans/Visibility.html#avoidingGui--), [dontUseGui](../../../java/beans/Visibility.html#dontUseGui--), [needsGui](../../../java/beans/Visibility.html#needsGui--), [okToUseGui](../../../java/beans/Visibility.html#okToUseGui--)`

Field Detail

 * #### globalHierarchyLock  
 static final [Object](../../../java/lang/Object.html "class in java.lang") globalHierarchyLock  
 This global lock is used by both `BeanContext` and `BeanContextServices` implementors to serialize changes in a `BeanContext` hierarchy and any service requests etc.

Method Detail

* #### instantiateChild  
[Object](../../../java/lang/Object.html "class in java.lang") instantiateChild([String](../../../java/lang/String.html "class in java.lang") beanName)  
                 throws [IOException](../../../java/io/IOException.html "class in java.io"),  
                        [ClassNotFoundException](../../../java/lang/ClassNotFoundException.html "class in java.lang")  
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 this `BeanContext`  
Returns:  
a javaBean named as a child of this`BeanContext`  
Throws:  
`[IOException](../../../java/io/IOException.html "class in java.io")` \- if an IO problem occurs  
`[ClassNotFoundException](../../../java/lang/ClassNotFoundException.html "class in java.lang")` \- if the class identified by the beanName parameter is not found  
* #### getResourceAsStream  
[InputStream](../../../java/io/InputStream.html "class in java.io") getResourceAsStream([String](../../../java/lang/String.html "class in java.lang") name,  
                                [BeanContextChild](../../../java/beans/beancontext/BeanContextChild.html "interface in java.beans.beancontext") bcc)  
                         throws [IllegalArgumentException](../../../java/lang/IllegalArgumentException.html "class in java.lang")  
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, or `null` if the resource could not be found.  
Throws:  
`[IllegalArgumentException](../../../java/lang/IllegalArgumentException.html "class in java.lang")` \- if the resource is not valid  
* #### getResource  
[URL](../../../java/net/URL.html "class in java.net") getResource([String](../../../java/lang/String.html "class in java.lang") name,  
                [BeanContextChild](../../../java/beans/beancontext/BeanContextChild.html "interface in java.beans.beancontext") bcc)  
         throws [IllegalArgumentException](../../../java/lang/IllegalArgumentException.html "class in java.lang")  
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](../../../java/lang/IllegalArgumentException.html "class in java.lang")` \- if the resource is not valid  
* #### addBeanContextMembershipListener  
void addBeanContextMembershipListener([BeanContextMembershipListener](../../../java/beans/beancontext/BeanContextMembershipListener.html "interface in java.beans.beancontext") 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](../../../java/beans/beancontext/BeanContextMembershipListener.html "interface in java.beans.beancontext") bcml)  
Removes the specified `BeanContextMembershipListener` so that it no longer receives `BeanContextMembershipEvent`s when the child `Component`(s) are added or removed.  
Parameters:  
`bcml` \- the `BeanContextMembershipListener` 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, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.

BeanContext (Java Platform SE 8 ) (original) (raw)

Field Summary

Method Summary

Field Detail

Method Detail