|
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.
The BeanContext acts a logical hierarchical container for JavaBeans.
@author Laurence P. G. Cable @version 1.19 0220 12/0203/0001 @since 1.2 @seealso java.beans.Beans @seealso java.beans.beancontext.BeanContextChild @seealso java.beans.beancontext.BeanContextMembershipListener @seealso java.beans.PropertyChangeEvent @seealso java.beans.VetoableChangeEvent @seealso java.beans.DesignMode @seealso java.beans.Visibility @seealso java.util.Collection
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.16 0217 12/0203/0001 @since 1.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
This interface is implemented by
@author Laurence P. G. Cable @version 1.BeanContextChildren
that have an AWTComponent
associated with them.6 027 12/0203/0001 @since 1.2 @seealso java.beans.beancontext.BeanContext @seealso java.beans.beancontext.BeanContextSupport
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.10 0211 12/0203/0001 @since 1.2 @seealso java.beans.beancontext.BeanContext @seealso java.beans.beancontext.BeanContextServices @seealso java.beans.beancontext.BeanContextChild
This interface is implemented by BeanContexts' that have an AWT Container associated with them.
@author Laurence P. G. Cable @version 1.6 027 12/0203/0001 @since 1.2 @seealso java.beans.beancontext.BeanContext @seealso java.beans.beancontext.BeanContextSupport
@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.9 0210 12/0203/0001 @since 1.2 @see java.beans.beancontext.BeanContext
ABeanContextMembershipEvent
encapsulates the list of children added to or removed from the membership of a particularBeanContext
. An instance of this event is fired whenever a successful add() remove() retainAll() removeAll() or clear() is invoked on a givenBeanContext
instance. Objects interested in receiving events of this type must implement theBeanContextMembershipListener
interface and must register their intent via theBeanContext
'saddBeanContextMembershipListener(BeanContextMembershipListener bcml)
method. @author Laurence P. G. Cable @version 1.1112 @since 1.2 @see java.beans.beancontext.BeanContext @see java.beans.beancontext.BeanContextEvent @see java.beans.beancontext.BeanContextMembershipListener
Compliant BeanContexts fire events on this interface when the state of the membership of the BeanContext changes.
@author Laurence P. G. Cable @version 1.9 0210 12/0203/0001 @since 1.2 @see java.beans.beancontext.BeanContext
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.7 028 12/0203/0001 @since 1.2 @seealso java.beans.beancontext.BeanContextChild @seealso java.beans.beancontext.BeanContextChildSupport
Checks this event to determine whether or not the service being revoked is of a particular class. @param service the service of interest (should be non-null) @return true
if the service being revoked is of the same class as the specified service
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.16 0217 12/0203/0001 @since 1.2
This helper class provides a utility implementation of the java.beans.beancontext.BeanContext interface.Class BeanContextSupport, boolean add(Object)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.38 0242 12/0203/0001 @since 1.2
Adds/nests a child within this BeanContext.Class BeanContextSupport, Object[] copyChildren()Invoked as a side effect of java.beans.Beans.instantiate(). If the child object is not valid for adding then this method throws an IllegalStateException.
@param targetChild The child objects to nest within this BeanContext @return true if the child was added successfully. @see #validatePendingAdd
Gets a copy of the this BeanContext's children. @Class BeanContextSupport, boolean remove(Object)returnsreturn a copy of the current nested children
Removes a child from this BeanContext. If the child object is not for adding then this method throws an IllegalStateException. @param targetChild The child objects to remove @see #validatePendingRemoveClass BeanContextSupport, void setLocale(Locale)
Sets the locale of this BeanContext. @param newLocale the new locale. This method call will have no effect if newLocale is null
. @throws PropertyVetoException if the new value is rejected
Class BeanContextSupport, boolean validatePendingAdd(Object)Class BeanContextSupport, boolean validatePendingRemove(Object)Subclasses of this class may override or envelope this method to add validation behavior for the BeanContext to examine child objects immediately prior to their being added to the BeanContext.
@returnsreturn true iff the child may be added to this BeanContext otherwise false.
Subclasses of this class may override or envelope this method to add validation behavior for the BeanContext to examine child objects immediately prior to their being removed from the BeanContext.
@returnsreturn true iff the child may be removed from this BeanContext otherwise false.