Generated by
JDiff

java.beans.beancontext Documentation Differences

This file contains all the changes in documentation in the package java.beans.beancontext as colored differences. Deletions are shown like 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

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

Class BeanContextChild

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

Class BeanContextChildComponentProxy

This interface is implemented by BeanContextChildren that have an AWT Component 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

Class BeanContextChildSupport

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.11 12 02/0322/0102 @since 1.2 @seealsosee java.beans.beancontext.BeanContext @seealsosee java.beans.beancontext.BeanContextServices @seealsosee java.beans.beancontext.BeanContextChild

Class BeanContextContainerProxy

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

Class BeanContextMembershipEvent

A BeanContextMembershipEvent encapsulates the list of children added to or removed from the membership of a particular BeanContext. An instance of this event is fired whenever a successful add() remove() retainAll() removeAll() or clear() is invoked on a given BeanContext instance. Objects interested in receiving events of this type must implement the BeanContextMembershipListener interface and must register their intent via the BeanContext's addBeanContextMembershipListener(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
Class BeanContextMembershipEvent, constructor BeanContextMembershipEvent(BeanContext, Collection)

Contruct a BeanContextMembershipEvent @param bc The BeanContext source @param changes The Children affected @throws NullPointerException if changes is null

Class BeanContextProxy

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) { // ... } or BeanContextChild 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

Class BeanContextSupport

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