|
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.20 1221 02/0322/0102 @since 1.2 @seealsosee java.beans.Beans @seealsosee java.beans.beancontext.BeanContextChild @seealsosee java.beans.beancontext.BeanContextMembershipListener @seealsosee java.beans.PropertyChangeEvent @seealsosee java.beans.VetoableChangeEvent @seealsosee java.beans.DesignMode @seealsosee java.beans.Visibility @seealsosee 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.17 1218 02/0322/0102 @since 1.2 @seealsosee java.beans.beancontext.BeanContext @seealsosee java.beans.PropertyChangeEvent @seealsosee java.beans.PropertyChangeListener @seealsosee java.beans.PropertyVetoEvent @seealsosee java.beans.PropertyVetoListener @seealsosee java.beans.PropertyVetoException
This interface is implemented by
@author Laurence P. G. Cable @version 1.BeanContextChildren
that have an AWTComponent
associated with them.7 128 02/0322/0102 @since 1.2 @seealsosee java.beans.beancontext.BeanContext @seealsosee 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.1112 02/0322/0102 @since 1.2 @seealsosee java.beans.beancontext.BeanContext @seealsosee java.beans.beancontext.BeanContextServices @seealsosee 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.7 128 02/0322/0102 @since 1.2 @seealsosee java.beans.beancontext.BeanContext @seealsosee java.beans.beancontext.BeanContextSupport
AClass BeanContextMembershipEvent, constructor BeanContextMembershipEvent(BeanContext, Collection)BeanContextMembershipEvent
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.1213 @since 1.2 @see java.beans.beancontext.BeanContext @see java.beans.beancontext.BeanContextEvent @see java.beans.beancontext.BeanContextMembershipListener
Contruct a BeanContextMembershipEvent @param bc The BeanContext source @param changes The Children affected @throws NullPointerException ifchanges
isnull
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.8 129 02/0322/0102 @since 1.2 @seealsosee java.beans.beancontext.BeanContextChild @seealsosee java.beans.beancontext.BeanContextChildSupport
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.42 1245 02/0325/0102 @since 1.2