BeanContext (Java Platform SE 7 ) (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 and 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

Methods

Modifier and Type	Method and 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%28java.lang.String,%20java.beans.PropertyChangeListener%29), [addVetoableChangeListener](../../../java/beans/beancontext/BeanContextChild.html#addVetoableChangeListener%28java.lang.String,%20java.beans.VetoableChangeListener%29), [getBeanContext](../../../java/beans/beancontext/BeanContextChild.html#getBeanContext%28%29), [removePropertyChangeListener](../../../java/beans/beancontext/BeanContextChild.html#removePropertyChangeListener%28java.lang.String,%20java.beans.PropertyChangeListener%29), [removeVetoableChangeListener](../../../java/beans/beancontext/BeanContextChild.html#removeVetoableChangeListener%28java.lang.String,%20java.beans.VetoableChangeListener%29), [setBeanContext](../../../java/beans/beancontext/BeanContextChild.html#setBeanContext%28java.beans.beancontext.BeanContext%29)`  
   * ### Methods inherited from interface java.util.[Collection](../../../java/util/Collection.html "interface in java.util")  
   `[add](../../../java/util/Collection.html#add%28E%29), [addAll](../../../java/util/Collection.html#addAll%28java.util.Collection%29), [clear](../../../java/util/Collection.html#clear%28%29), [contains](../../../java/util/Collection.html#contains%28java.lang.Object%29), [containsAll](../../../java/util/Collection.html#containsAll%28java.util.Collection%29), [equals](../../../java/util/Collection.html#equals%28java.lang.Object%29), [hashCode](../../../java/util/Collection.html#hashCode%28%29), [isEmpty](../../../java/util/Collection.html#isEmpty%28%29), [iterator](../../../java/util/Collection.html#iterator%28%29), [remove](../../../java/util/Collection.html#remove%28java.lang.Object%29), [removeAll](../../../java/util/Collection.html#removeAll%28java.util.Collection%29), [retainAll](../../../java/util/Collection.html#retainAll%28java.util.Collection%29), [size](../../../java/util/Collection.html#size%28%29), [toArray](../../../java/util/Collection.html#toArray%28%29), [toArray](../../../java/util/Collection.html#toArray%28T[]%29)`  
   * ### Methods inherited from interface java.beans.[DesignMode](../../../java/beans/DesignMode.html "interface in java.beans")  
   `[isDesignTime](../../../java/beans/DesignMode.html#isDesignTime%28%29), [setDesignTime](../../../java/beans/DesignMode.html#setDesignTime%28boolean%29)`  
   * ### Methods inherited from interface java.beans.[Visibility](../../../java/beans/Visibility.html "interface in java.beans")  
   `[avoidingGui](../../../java/beans/Visibility.html#avoidingGui%28%29), [dontUseGui](../../../java/beans/Visibility.html#dontUseGui%28%29), [needsGui](../../../java/beans/Visibility.html#needsGui%28%29), [okToUseGui](../../../java/beans/Visibility.html#okToUseGui%28%29)`

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`  
Throws:  
`` `IOException` ``  
`` `ClassNotFoundException` `` \- if the class identified by the beanName parameter is not found  
`[IOException](../../../java/io/IOException.html "class in java.io")`  
`[ClassNotFoundException](../../../java/lang/ClassNotFoundException.html "class in java.lang")`  
* #### 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` `` \- if the resource is not valid  
`[IllegalArgumentException](../../../java/lang/IllegalArgumentException.html "class in java.lang")`  
* #### 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` `` \- if the resource is not valid  
`[IllegalArgumentException](../../../java/lang/IllegalArgumentException.html "class in java.lang")`  
* #### 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, 2020, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.

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

Field Summary

Method Summary

Field Detail

Method Detail