|
Generated by JDiff |
||||||||
PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES |
This file contains all the changes in documentation in the packagejava.beans.beancontext
as colored differences. Deletions are shownlike this, and additions are shown like this.
If no deletions or additions are shown in an entry, the HTML tags will be what has changed. The new HTML tags are shown in the differences. If no documentation existed, and then some was added in a later version, this change is noted in the appropriate class pages of differences, but the change is not shown on this page. Only changes in existing text are shown here. Similarly, documentation which was inherited from another class or interface is not shown here.
Note that an HTML error in the new documentation may cause the display of other documentation changes to be presented incorrectly. For instance, failure to close a <code> tag will cause all subsequent paragraphs to be displayed differently.
Class BeanContext, void addBeanContextMembershipListener(BeanContextMembershipListener)The BeanContext acts a logical
@author Laurence P. G. Cable @version 1.heirarchicalhierarchical container for JavaBeans.919 02/02/00 @sinceJDK11.2 @seealso java.beans.Beans @seealso java.beans.beancontext.BeanContextChild @seealso java.beans.beancontext.BeanContextListenerBeanContextMembershipListener @seealso java.beans.PropertyChangeEvent @seealso java.beans.VetoableChangeEvent @seealso java.beans.DesignMode @seealso java.beans.Visibility @seealso java.util.Collection
Class BeanContext, URL getResource(String, BeanContextChild)addAdds the specifiedBeanContextMembershipListener
to receiveBeanContextMembershipEvents
from thisBeanContext
whenever it adds or removes a childComponent
(s). @param bcml theBeanContextMembershipListener to be added
Analagous toClass BeanContext, InputStream getResourceAsStream(String, BeanContextChild)java.lang.ClassLoader.getResource()
this method allows aBeanContext
implementation to interpose behavior between the childComponent
and underlyingClassLoader
. @param name the resource name @param bcc the specified child @return aURL
for the named resource for the specified child @throwthrowsIllegalArgumentException
if the resource is not valid
Class BeanContext, Object instantiateChild(String)@returnAnalagousantoInputStreamjava.lang.ClassLoader.getResourceAsStream()
this method allows aBeanContext
implementation to interpose behavior between thenamedchildComponent
and underlyingClassLoader
. @param name the resourceforname @param bcc the specified child @throwreturn anInputStream
for reading the resource ornull
if the resource could not be found. @throwsIllegalArgumentException
if the resource is not valid
Instantiate the javaBean named as a child of thisClass BeanContext, void removeBeanContextMembershipListener(BeanContextMembershipListener)BeanContext
. The implementation of the JavaBean is derived from the value of the beanName parameter and is defined by thejava.beans.Beans.instantiate()
method. @param beanName The name of the JavaBean to instantiate as a child of thisBeanContext
@throwsIOException
@throwsClassNotFoundException
if the class identified by the beanName parameter is not found
Class BeanContext, Object globalHierarchyLockremove aRemoves the specifiedBeanContextMembershipListener
so that it no longer receivesBeanContextMembershipEvent
s when the childComponent
(s) are added or removed. @param bcml theBeanContextMembershipListener to be removed
thisThis global lock is used by bothBeanContext
andBeanContextServices
implementors to serialize changes in aBeanContext
hierarchy and any service requests etc.
Class BeanContextChild, void addPropertyChangeListener(String, PropertyChangeListener)JavaBeans wishing to be nested within and obtain a reference to their execution environment or context as defined by the BeanContext sub-interface shall implement this interface.
Conformant BeanContexts shall as a side effect of adding a BeanContextChild object shall pass a reference to itself via the setBeanContext() method of this interface.
Note that a BeanContextChild may refuse a change in state by throwing PropertyVetoedException in response.
In order for persistence mechanisms to function properly on BeanContextChild instances across a broad variety of scenarios implementing classes of this interface are required to define as transient any or all fields or instance variables that may contain or represent references to the nesting BeanContext instance or other resources obtained from the BeanContext via any unspecified mechanisms.
@author Laurence P. G. Cable @version 1.1116 02/02/00 @sinceJDK11.2 @seealso java.beans.beancontext.BeanContext @seealso java.beans.PropertyChangeEvent @seealso java.beans.PropertyChangeListener @seealso java.beans.PropertyVetoEvent @seealso java.beans.PropertyVetoListener @seealso java.beans.PropertyVetoException
Class BeanContextChild, void addVetoableChangeListener(String, VetoableChangeListener)addAdds aPropertyChangeListener
to thisBeanContextChild
in order to receive aPropertyChangeEvent
whenever the specified propertychangehas changed. @param name thelistenername of the property tothislisten on @param pclbeanthechildPropertyChangeListener
to add
Class BeanContextChild, BeanContext getBeanContext()addAdds avetoableVetoableChangeListener
tochangethislistenerBeanContextChild
tothisreceive events whenever the specified property changes. @param name the namechildof the property to listen on @param vcl theVetoableChangeListener
to add
Class BeanContextChild, void removePropertyChangeListener(String, PropertyChangeListener)@returnsGets thecurrentBeanContext
associated with thisBeanContextChild
. @return theJavaBeanBeanContext
associated with thisBeanContextChild
.
Class BeanContextChild, void removeVetoableChangeListener(String, VetoableChangeListener)removeRemoves aPropertyChangeListener
from thisBeanContextChild
so that it no longer receivesPropertyChangeEvents
when the specified propertychangeislistenerchanged.to@paramthisname the name of the property that wasbeanlistenedchildon @param pcl thePropertyChangeListener
to remove
Class BeanContextChild, void setBeanContext(BeanContext)removeRemoves avetoableVetoableChangeListener
change listenerfrom thistoBeanContextChild
thisso that it no longer receives events when the specified property changes. @param namechildthe name of the property that was listened on. @param vcl theVetoableChangeListener
to remove.
Objects that implement this interface shall fire a java.beans.PropertyChangeEvent with parameters:
@parampropertyName "beanContext"@paramoldValue (the previous nestingBeanContext
instance ornull
)@paramnewValue (the current nestingBeanContext
instance ornull
).A change in the value of the nesting BeanContext property of this BeanContextChild may be vetoed by throwing the appropriate exception.
@param bc TheBeanContext
with which to associate thisBeanContextChild
. @throwsPropertyVetoException
if the addition of the specifiedBeanContext
is refused.
Class BeanContextChildComponentProxy, Component getComponent()This interface is implemented by
@author Laurence P. G. Cable @version 1.BeanContextChildren
that have an AWTComponent
associated with them.16 02/02/00 @sinceJDK11.2 @seealso java.beans.beancontext.BeanContext @seealso java.beans.beancontext.BeanContextSupport
Gets thejava.awt.Component
associated with thisBeanContextChild
. @return the AWTComponent
associated with thisBeanContextChild
Class BeanContextChildSupport, void addPropertyChangeListener(String, PropertyChangeListener)This is a general support class to provide support for implementing the BeanContextChild protocol. This class may either be directly subclassed or encapsulated and delegated to in order to implement this interface for a given component.
@author Laurence P. G. Cable @version 1.410 02/02/00 @sinceJDK11.2 @seealso java.beans.beancontext.BeanContext @seealso java.beans.beancontext.BeanContextServices @seealso java.beans.beancontext.BeanContextChild
Class BeanContextChildSupport, void addVetoableChangeListener(String, VetoableChangeListener)addAdds a property change listener. @param name The name of the property to listen on @param pcl ThePropertyChangeListener
to be added
Class BeanContextChildSupport, void firePropertyChange(String, Object, Object)addAdds avetoableVetoableChangeListener
.change@paramlistenername The name of the property to listen on @param vcl TheVetoableChangeListener
to be added
Class BeanContextChildSupport, void fireVetoableChange(String, Object, Object)firesReport apropertyChangeboundEventproperty update to any registered listeners. No event is fired if old and new are equal and non-null. @param name The programmatic name of the property that was changed @param oldValue The old value of the property @param newValue The new value of the property
Class BeanContextChildSupport, BeanContext getBeanContext()firesReport avetoableChangevetoableEventproperty update to any registered listeners. If anyone vetos the change then fire a new event reverting everyone to the old value and then rethrow the PropertyVetoException.No event is fired if old and new are equal and non-null.
@param name The programmatic name of the property that is about to change @param oldValue The old value of the property @param newValue - The new value of the property @throws PropertyVetoException if the recipient wishes the property change to be rolled back.
Class BeanContextChildSupport, BeanContextChild getBeanContextChildPeer()@returnsGets thecurrentnestingBeanContext
for thisassociatedBeanContextChildSupport
.with@return theJavaBeannestingBeanContext
for thisBeanContextChildSupport
.
Gets the BeanContextChild associated with this BeanContextChildSupport. @return the BeanContextChild peer of this classClass BeanContextChildSupport, boolean isDelegated()
Reports whether or not this class is a delegate of another. @return true if this class is a delegate of anotherClass BeanContextChildSupport, void removePropertyChangeListener(String, PropertyChangeListener)
Class BeanContextChildSupport, void removeVetoableChangeListener(String, VetoableChangeListener)removeRemove a property change listener. @param name The name of the property that was listened on @param pcl The PropertyChangeListener to be removed
Class BeanContextChildSupport, void serviceAvailable(BeanContextServiceAvailableEvent)removeRemoves avetoableVetoableChangeListener
.change@paramlistenername The name of the property that was listened on @param vcl TheVetoableChangeListener
to be removed
Class BeanContextChildSupport, void serviceRevoked(BeanContextServiceRevokedEvent)aA new service is available from the nesting BeanContext.subclassesSubclasses may override this method in order to implement their own behaviors @param bcsae The BeanContextServiceAvailableEvent fired as a result of a service becoming available
Class BeanContextChildSupport, void setBeanContext(BeanContext)aA service provided by the nesting BeanContext has been revoked.subclassesSubclasses may override this method in order to implement their own behaviors. @param bcsre TheBeanContextServiceRevokedEvent
fired as a result of a service being revoked
Class BeanContextChildSupport, boolean validatePendingSetBeanContext(BeanContext)setBeanContextSets theBeanContext
for thisBeanContextChildSupport
. @param bc the new value to be assigned to theBeanContext
property @throwsPropertyVetoException
if the change is rejected
calledCalled from setBeanContext to validate (or otherwise) the pending change in the nesting BeanContext property value.returningReturning false will cause setBeanContext to throw PropertyVetoException. @param newValue the new value that has been requested for the BeanContext property @returntrue
if the change operation is to be vetoed
Class BeanContextContainerProxy, Container getContainer()This interface is implemented by BeanContexts' that have an AWT Container associated with them.
@author Laurence P. G. Cable @version 1.16 02/02/00 @sinceJDK11.2 @seealso java.beans.beancontext.BeanContext @seealso java.beans.beancontext.BeanContextSupport
Gets thejava.awt.Container
associated with thisBeanContext
. @return theAWTjava.awt.Container
associated with thisBeanContext
.
Class BeanContextEvent, BeanContext getPropagatedFrom()@author Laurence P. G. Cable @version 1.
BeanContextEvent
is the abstract root event class for all events emitted from and pertaining to the semantics of aBeanContext
. This class introduces a mechanism to allow the propagation ofBeanContextEvent
subclasses through a heirarchy ofBeanContext
s. ThesetPropagatedFrom()
andgetPropagatedFrom()
methods allow aBeanContext
to identify itself as the source of a propagated event.29 02/02/00 @sinceJDK11.2 @see java.beans.beancontext.BeanContext
Gets theClass BeanContextEvent, boolean isPropagated()BeanContext
from which this event was propagated. @param bc TheBeanContext
that last propagated thisBeanContextEvent
@return theBeanContext
from which this event was propagated
Class BeanContextEvent, void setPropagatedFrom(BeanContext)@returnReports whether or not this event isthepropagated from someBeanContextEventotherBeanContext
. @returntrue
if propagatedfalse
if not
Sets theBeanContext
from which this event was propagated. @param bcSettheBeanContext
thatlast propagatedfrom which thisBeanContextEventevent was propagated
AClass BeanContextMembershipEvent, constructor BeanContextMembershipEvent(BeanContext, Collection)CompliantBeanContextMembershipEvent
BeanContexts fire events on this interface when state maintained byencapsulates the list of children added to or removed from the membership of a particularBeanContext. An instance of this event
for someis fired whenever a successful add() remove() retainAll() removeAll() orallclear() is invoked on a givenBeanContext
instance. Objects interested in receiving events ofitsthis"children"typechangesmusttoimplement theBeanContextMembershipListener
all BeanContextListeners thatinterface and must registerthemselvestheirwith a particularintent via theBeanContext
's.addBeanContextMembershipListener(BeanContextMembershipListener
bcml) method. @author Laurence P. G. Cable @version 1.611 @since 1.2 @see java.beans.beancontext.BeanContext @see java.beans.beancontext.BeanContextEvent @see java.beans.beancontext.BeanContextListenerBeanContextMembershipListener
Contruct a BeanContextMembershipEvent @param bc The BeanContext source @param changes The ChildrenClass BeanContextMembershipEvent, constructor BeanContextMembershipEvent(BeanContext, Object[])effectedaffected
Contruct a BeanContextMembershipEvent @param bc The BeanContext source @param changes The Children effected @exception NullPointerException if changes associated with this event are null.Class BeanContextMembershipEvent, boolean contains(Object)
Class BeanContextMembershipEvent, Iterator iterator()@return isIs the child specifiedeffectedaffected by the event @returntrue
if affectedfalse
if not
Gets the array of children affected by this event. @return the array of children effectedClass BeanContextMembershipEvent, int size()
Class BeanContextMembershipEvent, Object[] toArray()howGetsmanythe number of childrenareaffected by the notification. @return the number of childreneffectedaffected by the notification
Gets the array of children affected by this event. @return the array of childreneffectedaffected
Class BeanContextMembershipListener, void childrenAdded(BeanContextMembershipEvent)Compliant BeanContexts fire events on this interface when the state of the membership of the BeanContext changes.
@author Laurence P. G. Cable @version 1.49 02/02/00 @sinceJDK11.2 @see java.beans.beancontext.BeanContext
Called when a child or list of children is added to aClass BeanContextMembershipListener, void childrenRemoved(BeanContextMembershipEvent)BeanContext
that this listener is registered with. @param bcme TheBeanContextMembershipEvent
describing the change that occurred.
Called when a child or list of children is removed from aBeanContext
that this listener is registered with. @param bcme TheBeanContextMembershipEvent
describing the change that occurred.
Class BeanContextProxy, BeanContextChild getBeanContextProxy()This interface is implemented by a JavaBean that does not directly have a BeanContext(Child) associated with it (via implementing that interface or a subinterface thereof) but has a public BeanContext(Child) delegated from it. For example a subclass of java.awt.Container may have a BeanContext associated with it that all Component children of that Container shall be contained within.
An Object may not implement this interface and the BeanContextChild interface (or any subinterfaces thereof) they are mutually exclusive.
Callers of this interface shall examine the return type in order to obtain a particular subinterface of BeanContextChild as follows:
BeanContextChild bcc = o.getBeanContextProxy(); if (bcc instanceof BeanContext) { // ... }
orBeanContextChild bcc = o.getBeanContextProxy(); BeanContext bc = null; try { bc = (BeanContext)bcc; } catch (ClassCastException cce) { // cast failed bcc is not an instanceof BeanContext }
The return value is a constant for the lifetime of the implementing instance
@author Laurence P. G. Cable @version 1.17 02/02/00 @sinceJDK11.2 @seealso java.beans.beancontext.BeanContextChild @seealso java.beans.beancontext.BeanContextChildSupport
Gets theBeanContextChild
(or subinterface) associated with this object. @return theBeanContextChild
(or subinterface) associated with thisObjectobject
Class BeanContextServiceAvailableEvent, Iterator getCurrentServiceSelectors()constructConstruct aBeanContextServiceEventBeanContextAvailableServiceEvent
. @param bcs The context in which the service has become available @param sc AClass
reference to the newly available service
Gets the list of service dependent selectors. @return the current selectors available from the serviceClass BeanContextServiceAvailableEvent, Class getServiceClass()
Class BeanContextServiceAvailableEvent, BeanContextServices getSourceAsBeanContextServices()getGets the service class that is the subject of this notification. @return AClass
reference to the newly available service
getGets the source as a reference of typeBeanContextServices
. @return The context in which the service has become available
Invoked byClass BeanContextServiceProvider, Object getService(BeanContextServices, Object, Class, Object)BeanContextServices
this method gets the current service selectors for the specified service. A service selector is a service specific parameter typical examples of which could include: a parameter to a constructor for the service implementation class a value for a particular service's property or a key into a map of existing implementations. @param bcs theBeanContextServices
for this request @param service the specified service @return the current service selectors for the specified serviceClass
Class BeanContextServiceProvider, void releaseService(BeanContextServices, Object, Object)requestInvoked byBeanContextServices
this method requests an instance of a service from thisBeanContextServiceProvider
. @param bcs TheBeanContextServices
associated with this particular request. This parameter enables theBeanContextServiceProvider
to distinguish service requests from multiple sources. @param requestor The object requesting the service @param serviceClass The service requested @param serviceSelectorAdditionalthe serviceparameterisationdependentofparameter for a particular service ornull
if not applicable. @return a reference to the requested service
Invoked byBeanContextServices
this method releases a nestedBeanContextChild
's (or any arbitrary object associated with aBeanContextChild
) reference to the specified service. @param bcs theBeanContextServices
associated with this particular release request @param requestor the object requesting the service to be released @param service the service that is to be released
@return an arrayGetsofaBeanInfo
array one for each service class or interface statically available from this ServiceProviderclass. @return theBeanInfo
array
Class BeanContextServiceRevokedEvent, constructor BeanContextServiceRevokedEvent(BeanContextServices, Class, boolean)This event type is used by the
BeanContextServicesListenerBeanContextServiceRevokedListener
in order to identify the service being revoked.
Class BeanContextServiceRevokedEvent, Class getServiceClass()constructConstruct aBeanContextServiceEvent
. @param bcs theBeanContextServices
from which this service is being revoked @param sc the service that is being revoked @param invalidatetrue
for immediate revocation
Class BeanContextServiceRevokedEvent, BeanContextServices getSourceAsBeanContextServices()getGets the service class that is the subject of this notification @return AClass
reference to the service that is being revoked
Class BeanContextServiceRevokedEvent, boolean isCurrentServiceInvalidNow()getGets the source as a reference of typeBeanContextServices
@return theBeanContextServices
from which this service is being revoked
Class BeanContextServiceRevokedEvent, boolean isServiceClass(Class)trueReports if the current service is being forcibly revoked in which case the references are now invalidated and unusable. @returntrue
if current service is being forcibly revoked
Class BeanContextServiceRevokedEvent, Class serviceClasstestChecks this event to determine whether or not the service being revoked is of a particular class. @param service the service of interest @returntrue
if the serviceequalitybeing revoked is of the same class as the specified service
fieldsAClass
reference to the service that is being revoked.
The service named has been revoked. getService requests for this service will no longer be satisifed. @param bcsre the BeanContextServiceRevokedEvent
received by this listener.
Class BeanContextServices, boolean addService(Class, BeanContextServiceProvider)addAdds aBeanContextServicesListener
to this BeanContext @param bcsl theBeanContextServicesListener
to add
Class BeanContextServices, Iterator getCurrentServiceClasses()addAdds a service to this BeanContext.BeanContextServiceProvider
s call this method to register a particular service with this context. If the service has not previously been added theBeanContextServices
associates the service with theBeanContextServiceProvider
and fires aBeanContextServiceAvailableEvent
to all currently registeredBeanContextServicesListeners
. The method then returnstrue
indicating that the addition of the service was successful. If the given service has already been added this method simply returnsfalse
. @paramserviceClass
the service to add @param serviceProvider theBeanContextServiceProvider
associated with the service
Gets the currently available services for this context. @return an Iterator
consisting of the currently available services
Class BeanContextServices, Iterator getCurrentServiceSelectors(Class)Gets the list of service dependent service parameters (Service Selectors) for the specified service by calling getCurrentServiceSelectors() on the underlying BeanContextServiceProvider. @param serviceClass the specified service @return the currently available service selectors for the named serviceClassClass BeanContextServices, Object getService(BeanContextChild, Object, Class, Object, BeanContextServiceRevokedListener)
AClass BeanContextServices, boolean hasService(Class)BeanContextChild
or any arbitrary object associated with aBeanContextChild
may obtain a reference to a currently registered service from its nestingBeanContextServices
via invocation of this method. When invoked this method gets the service by calling the getService() method on the underlyingBeanContextServiceProvider
. @param child theBeanContextChild
associated with this request @param requestor the object requesting the service @param serviceClass class of the requested service @param serviceSelector the service dependent parameter @param bcsrl theBeanContextServiceRevokedListener
to notify if the service should later become revoked @throws TooManyListenersException @return a reference to this context's named Service as requested ornull
Reports whether or not a given service is currently available from this context. @param serviceClass the service in question @return trueClass BeanContextServices, void releaseService(BeanContextChild, Object, Object)iffif the service is available.
Class BeanContextServices, void removeBeanContextServicesListener(BeanContextServicesListener)releaseReleases aBeanContextChild
's (or any arbitrary object associated with a BeanContextChild) reference to the specified servicereferenceby calling releaseService() on the underlyingBeanContextServiceProvider
. @param child theBeanContextChild
@param requestor the requestor @param service the service
Class BeanContextServices, void revokeService(Class, BeanContextServiceProvider, boolean)removeRemoves aBeanContextServicesListener
from thisBeanContext
@param bcsl theBeanContextServicesListener
to remove from this context
BeanContextServiceProviders wishing to remove a currently registered service from this context may do so via invocation of this method. Upon revocation of the service theBeanContextServices
fires aBeanContextServiceRevokedEvent
to its list of currently registeredBeanContextServiceRevokedListeners
andBeanContextServicesListeners
. @param serviceClass the service to revoke from thisBeanContextBeanContextServices @param serviceProvider the BeanContextServiceProvider associated with this particular service that is being revoked @param revokeCurrentServicesNow a value oftrue
indicates an exceptional circumstance where theBeanContextServiceProvider
orBeanContextServices
wishes to immediately terminate service to all currently outstanding references to the specified service.
The service named has been registered. getService requests for this service may now be made. @param bcsae the BeanContextServiceAvailableEvent
Class BeanContextServicesSupport, void fireServiceAdded(Class)This helper class provides a utility implementation of the java.beans.beancontext.BeanContextServices interface.
Since this class directly implements the BeanContextServices interface the class can and is intended to be used either by subclassing this implementation or via delegation of an instance of this class from another through the BeanContextProxy interface.
@author Laurence P. G. Cable @version 1.916 02/02/00 @sinceJDK11.2
Class BeanContextServicesSupport, void fireServiceRevoked(BeanContextServiceRevokedEvent)FireFires a BeanContextServiceEvent notifying of a new service.
Class BeanContextServicesSupport, BeanContextServices getBeanContextServicesPeer()FireFires a BeanContextServiceEvent notifying of a service being revoked. @param bcsre the BeanContextServiceRevokedEvent
Gets the BeanContextServices associated with this BeanContextServicesSupport. @return the instance of BeanContext this object is providing theClass BeanContextServicesSupport, BeanContextServicesListener getChildBeanContextServicesListener(Object)implemen tationimplementation for.
Gets the BeanContextServicesListener (if any) of the specified child. @param child the specified child @return the BeanContextServicesListener (if any) of the specified child
Class BeanContextSupport, constructor BeanContextSupport(BeanContext)This helper class provides a utility implementation of the java.beans.beancontext.BeanContext interface.Since this class directly implements the BeanContext interface the class can and is intended to be used either by subclassing this implementation or via ad-hoc delegation of an instance of this class from another.
@author Laurence P. G. Cable @version 1.2938 02/02/00 @sinceJDK11.2
Create an instance using with a default locale @param peer The peer BeanContext we are supplying an implementation forClass BeanContextSupport, constructor BeanContextSupport(BeanContext, Locale)ifor nulltheif this object is its own peer
Create an instance using the specified locale @param peer The peer BeanContext we are supplying an implementation forClass BeanContextSupport, constructor BeanContextSupport(BeanContext, Locale, boolean)ifor nulltheif this object is its own peer @param lcle The current Locale for this BeanContext. If lcle is null the default locale is assigned to the BeanContext instance. @see java.util.Locale#getDefault() @see java.util.Locale@#setDefault(java.util.Locale)
Create an instance using the specified Locale and design mode. @param peer The peer BeanContext we are supplying an implementation forClass BeanContextSupport, constructor BeanContextSupport(BeanContext, Locale, boolean, boolean)ifor nulltheif this object is its own peer @param lcle The current Locale for this BeanContext. If lcle is null the default locale is assigned to the BeanContext instance. @param dtime The initial state true if in design mode false if runtime. @see java.util.Locale#getDefault() @see java.util.Locale@#setDefault(java.util.Locale)
Class BeanContextSupport, boolean add(Object)Construct a BeanContextSupport instance@param peer The peer BeanContext we are supplying an implementation forifor nulltheif this object is its own peer @param lcle The current Locale for this BeanContext. If lcle is null the default locale is assigned to the BeanContext instance. @param dtime The initial state true if in design mode false if runtime. @param visible The initial visibility. @see java.util.Locale#getDefault() @see java.util.Locale@#setDefault(java.util.Locale)
Class BeanContextSupport, boolean addAll(Collection)Adds/nests a child within this BeanContext.Invoked as a side effect of java.beans.Beans.instantiate().
@paramtargetChildrentargetChild The child objects to nest within this BeanContext @return true if the child was added successfully.
add Collection to set of Children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field @throws UnsupportedOperationExceptionClass BeanContextSupport, boolean avoidingGui()
Used to determine if the BeanContext child is avoiding using its GUI. @return is this instance avoiding using its GUI @see VisibilityClass BeanContextSupport, Iterator bcsChildren()
Returns an iterator of all children of this BeanContext. @return an iterator for all the current BCSChild valuesClass BeanContextSupport, void childDeserializedHook(Object, BCSChild)
Class BeanContextSupport, boolean classEquals(Class, Class)calledCalled by readObject with the newly deserialized child and BCSChild. @param child the newly deserialized child @param bcsc the newly deserialized BCSChild
Class BeanContextSupport, void clear()@returnTests to see if two class objects or their names are equal. @param first the first object @param second the second object @return true if equal false if not
clear the children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field @throws UnsupportedOperationExceptionClass BeanContextSupport, boolean contains(Object)
Determines whether or not the specified object is currently a child of this BeanContext. @param o the Object in question @return if this object is a childClass BeanContextSupport, boolean containsAll(Collection)
Class BeanContextSupport, boolean containsKey(Object)@returnTests to see if allobjectobjects in the specified Collection are children of this BeanContext. @param c the specified Collection @return true if all objects in the collection are children of this BeanContext false if not.
Determines whether or not the specified object is currently a child of this BeanContext. @param o the Object in question @return if this object is a childClass BeanContextSupport, Object[] copyChildren()
Gets a copy of the this BeanContext's children. @returns a copy of the current nested childrenClass BeanContextSupport, void deserialize(ObjectInputStream, Collection)
used by readObject to deserialize a collection. @param ois the ObjectInputStream to use @param coll the CollectionClass BeanContextSupport, BeanContext getBeanContextPeer()
Class BeanContextSupport, BeanContextChild getChildBeanContextChild(Object)@returnGets the instance of BeanContext that this object is providing theimplemen tationimplementation for. @return the BeanContext instance
Gets the BeanContextChild (if any) of the specified child @param child the specified child @return the BeanContextChild (if any) of the specified child @throw IllegalArgumentException if child implements both BeanContextChild and BeanContextProxyClass BeanContextSupport, BeanContextMembershipListener getChildBeanContextMembershipListener(Object)
Gets the BeanContextMembershipListener (if any) of the specified child @param child the specified child @return the BeanContextMembershipListener (if any) of the specified childClass BeanContextSupport, PropertyChangeListener getChildPropertyChangeListener(Object)
Gets the PropertyChangeListener (if any) of the specified child @param child the specified child @return the PropertyChangeListener (if any) of the specified childClass BeanContextSupport, Serializable getChildSerializable(Object)
Gets the Serializable (if any) associated with the specified Child @param child the specified child @return the Serializable (if any) associated with the specified ChildClass BeanContextSupport, VetoableChangeListener getChildVetoableChangeListener(Object)
Gets the VetoableChangeListener (if any) of the specified child @param child the specified child @return the VetoableChangeListener (if any) of the specified childClass BeanContextSupport, Visibility getChildVisibility(Object)
Gets the Component (if any) associated with the specified child. @param child the specified child @return the Component (if any) associated with the specifiedClass BeanContextSupport, Locale getLocale()Childchild.
Gets the locale for this BeanContext. @return the current Locale of the BeanContextClass BeanContextSupport, Object instantiateChild(String)
Class BeanContextSupport, boolean isDesignTime()The instantiateChild method is a convenience hook in BeanContext to simplify the task of instantiating a Bean nested into a BeanContext.
The semantics of the beanName parameter are defined by java.beans.Beans.instantate.
@param beanName the name of the Bean to instantiate within this BeanContext @throws IOException if there is an I/O error when the bean is being deserialized @throws ClassNotFoundException if the class identified by the beanName parameter is not found @return the new object
Reports whether or not this object is in currently in design time mode. @returnClass BeanContextSupport, boolean isEmpty()Designtrue if in design time mode false if not
Reports whether or not this BeanContext is empty. A BeanContext is considered empty when it contains zero nested children. @return if there are not childrenClass BeanContextSupport, boolean isSerializing()
Is this BeanContext in the process of being serialized @return if this BeanContext is currently being serializedClass BeanContextSupport, Iterator iterator()
Gets all JavaBean or BeanContext instances currently nested in this BeanContext. @return an Iterator of theClass BeanContextSupport, boolean remove(Object)iteratornested children
Removes a child from this BeanContext. @paramClass BeanContextSupport, boolean removeAll(Collection)targetChildrentargetChild The child objects to remove
remove all specified children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field @throws UnsupportedOperationExceptionClass BeanContextSupport, boolean retainAll(Collection)
retain only specified children (Unsupported) implementations must synchronized on the hierarchy lock and "children" protected field @throws UnsupportedOperationExceptionClass BeanContextSupport, void setDesignTime(boolean)
Sets the new design time value for this BeanContext. @param dTime the new designTime valueClass BeanContextSupport, void setLocale(Locale)
Sets the locale of this BeanContext. @param newLocale the new locale @throws PropertyVetoException if the new value is rejectedClass BeanContextSupport, int size()
Gets the number of children currently nested in this BeanContext. @return number of childrenClass BeanContextSupport, Object[] toArray()
Class BeanContextSupport, Object[] toArray(Object[])@returnGetsan array ofall JavaBean orchildrenBeanContext instances currently nested in this BeanContext.
Gets an array containing all children of this BeanContext that match the types contained in arry. @param arry The array of object types that are of interest. @return an array of children