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.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

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.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

Class BeanContextChildComponentProxy

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

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.10 0211 12/0203/0001 @since 1.2 @seealso java.beans.beancontext.BeanContext @seealso java.beans.beancontext.BeanContextServices @seealso 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.6 027 12/0203/0001 @since 1.2 @seealso java.beans.beancontext.BeanContext @seealso java.beans.beancontext.BeanContextSupport

Class BeanContextEvent

BeanContextEvent is the abstract root event class for all events emitted from and pertaining to the semantics of a BeanContext. This class introduces a mechanism to allow the propagation of BeanContextEvent subclasses through a heirarchy of BeanContexts. The setPropagatedFrom() and getPropagatedFrom() methods allow a BeanContext to identify itself as the source of a propagated event.

@author Laurence P. G. Cable @version 1.9 0210 12/0203/0001 @since 1.2 @see java.beans.beancontext.BeanContext

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.1112 @since 1.2 @see java.beans.beancontext.BeanContext @see java.beans.beancontext.BeanContextEvent @see java.beans.beancontext.BeanContextMembershipListener

Class 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

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.7 028 12/0203/0001 @since 1.2 @seealso java.beans.beancontext.BeanContextChild @seealso java.beans.beancontext.BeanContextChildSupport

Class BeanContextServiceRevokedEvent, boolean isServiceClass(Class)

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

Class BeanContextServicesSupport

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

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.38 0242 12/0203/0001 @since 1.2
Class BeanContextSupport, boolean add(Object)

Adds/nests a child within this BeanContext.

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
Class BeanContextSupport, Object[] copyChildren()

Gets a copy of the this BeanContext's children. @returnsreturn a copy of the current nested children
Class BeanContextSupport, boolean remove(Object)

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 #validatePendingRemove
Class 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)

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.
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 removed from the BeanContext.

@returnsreturn true iff the child may be removed from this BeanContext otherwise false.