Class BeanContextSupport

protected transient HashMap<Object, BeanContextSupport.BCSChild> children

protected transient ArrayList<BeanContextMembershipListener> bcmListeners

protected Locale locale

protected boolean okToUseGui

protected boolean designTime

public BeanContextSupport(BeanContext peer, Locale lcle, boolean dTime, boolean visible)

Parameters:

peer - The peer BeanContext we are supplying an implementation for, or null if this object is its own peer

lcle - The current Locale for this BeanContext. If lcle is null, the default locale is assigned to the BeanContext instance.

dTime - The initial state, true if in design mode, false if runtime.

visible - The initial visibility.

See Also:

• Locale.getDefault()
• Locale.setDefault(java.util.Locale)

public BeanContextSupport(BeanContext peer, Locale lcle, boolean dtime)

Parameters:

peer - The peer BeanContext we are supplying an implementation for, or null if this object is its own peer

lcle - The current Locale for this BeanContext. If lcle is null, the default locale is assigned to the BeanContext instance.

dtime - The initial state, true if in design mode, false if runtime.

See Also:

• Locale.getDefault()
• Locale.setDefault(java.util.Locale)

public BeanContextSupport(BeanContext peer, Locale lcle)

Parameters:

peer - The peer BeanContext we are supplying an implementation for, or null if this object is its own peer

lcle - The current Locale for this BeanContext. If lcle is null, the default locale is assigned to the BeanContext instance.

See Also:

• Locale.getDefault()
• Locale.setDefault(java.util.Locale)

public BeanContextSupport(BeanContext peer)

Parameters:

peer - The peer BeanContext we are supplying an implementation for, or null if this object is its own peer

public BeanContextSupport()

public BeanContext getBeanContextPeer()

Returns:

the BeanContext instance

public Object instantiateChild(String beanName) throws IOException, ClassNotFoundException

Specified by:

instantiateChild in interface BeanContext

Parameters:

beanName - the name of the Bean to instantiate within this BeanContext

Returns:

the new object

Throws:

IOException - if there is an I/O error when the bean is being deserialized

ClassNotFoundException - if the class identified by the beanName parameter is not found

public int size()

Specified by:

size in interface Collection

Returns:

number of children

public boolean isEmpty()

Specified by:

isEmpty in interface Collection

Returns:

true if there are no children, otherwise false

public boolean contains(Object o)

Specified by:

contains in interface Collection

Parameters:

o - the Object in question

Returns:

true if this object is a child, otherwise false

public boolean containsKey(Object o)

Parameters:

o - the Object in question

Returns:

true if this object is a child, otherwise false

public Iterator<Object> iterator()

Specified by:

iterator in interface Collection

Specified by:

iterator in interface Iterable

Returns:

an Iterator of the nested children

public Object[] toArray()

Specified by:

toArray in interface Collection

Returns:

an array, whose runtime component type is Object, containing all of the elements in this collection

public Object[] toArray(Object[] arry)

Specified by:

toArray in interface Collection

Parameters:

arry - The array of object types that are of interest.

Returns:

an array of children

protected BeanContextSupport.BCSChild createBCSChild(Object targetChild, Object peer)

Parameters:

targetChild - the child to create the Child on behalf of

peer - the peer if the tragetChild and the peer are related by an implementation of BeanContextProxy

Returns:

Subtype-specific subclass of Child without overriding collection methods

public boolean add(Object targetChild)

Specified by:

add in interface Collection

Parameters:

targetChild - The child objects to nest within this BeanContext

Returns:

true if the child was added successfully.

See Also:

• validatePendingAdd(Object)

public boolean remove(Object targetChild)

Specified by:

remove in interface Collection

Parameters:

targetChild - The child objects to remove

Returns:

true if an element was removed as a result of this call

See Also:

• validatePendingRemove(Object)

protected boolean remove(Object targetChild, boolean callChildSetBC)

Parameters:

targetChild - the JavaBean, BeanContext, or Object to be removed

callChildSetBC - used to indicate that the child should be notified that it is no longer nested in this BeanContext.

Returns:

whether or not was present before being removed

public boolean containsAll(Collection c)

Specified by:

containsAll in interface Collection

Parameters:

c - the specified Collection

Returns:

true if all objects in the collection are children of this BeanContext, false if not.

See Also:

• Collection.contains(Object)

public boolean addAll(Collection c)

Specified by:

addAll in interface Collection

Parameters:

c - collection containing elements to be added to this collection

Returns:

this implementation unconditionally throws UnsupportedOperationException

Throws:

UnsupportedOperationException - thrown unconditionally by this implementation

See Also:

• Collection.add(Object)

public boolean removeAll(Collection c)

Specified by:

removeAll in interface Collection

Parameters:

c - collection containing elements to be removed from this collection

Returns:

this implementation unconditionally throws UnsupportedOperationException

Throws:

UnsupportedOperationException - thrown unconditionally by this implementation

See Also:

• Collection.remove(Object)
• Collection.contains(Object)

public boolean retainAll(Collection c)

Specified by:

retainAll in interface Collection

Parameters:

c - collection containing elements to be retained in this collection

Returns:

this implementation unconditionally throws UnsupportedOperationException

Throws:

UnsupportedOperationException - thrown unconditionally by this implementation

See Also:

• Collection.remove(Object)
• Collection.contains(Object)

public void clear()

Specified by:

clear in interface Collection

Throws:

UnsupportedOperationException - thrown unconditionally by this implementation

public void addBeanContextMembershipListener(BeanContextMembershipListener bcml)

Specified by:

addBeanContextMembershipListener in interface BeanContext

Parameters:

bcml - the BeanContextMembershipListener to add

Throws:

NullPointerException - if the argument is null

public void removeBeanContextMembershipListener(BeanContextMembershipListener bcml)

Specified by:

removeBeanContextMembershipListener in interface BeanContext

Parameters:

bcml - the BeanContextMembershipListener to remove

Throws:

NullPointerException - if the argument is null

public InputStream getResourceAsStream(String name, BeanContextChild bcc)

Specified by:

getResourceAsStream in interface BeanContext

Parameters:

name - the name of the resource requested.

bcc - the child object making the request.

Returns:

the requested resource as an InputStream

Throws:

NullPointerException - if the argument is null

public URL getResource(String name, BeanContextChild bcc)

Specified by:

getResource in interface BeanContext

Parameters:

name - the name of the resource requested.

bcc - the child object making the request.

Returns:

the requested resource as an InputStream

public void setDesignTime(boolean dTime)

Specified by:

setDesignTime in interface DesignMode

Parameters:

dTime - the new designTime value

See Also:

• BeanContext
• BeanContextMembershipListener
• PropertyChangeEvent

public boolean isDesignTime()

Specified by:

isDesignTime in interface DesignMode

Returns:

true if in design time mode, false if not

public void setLocale(Locale newLocale) throws PropertyVetoException

Parameters:

newLocale - the new locale. This method call will have no effect if newLocale is null.

Throws:

PropertyVetoException - if the new value is rejected

public Locale getLocale()

Returns:

the current Locale of the BeanContext

public boolean needsGui()

Specified by:

needsGui in interface Visibility

Returns:

true if the implementor needs a GUI

public void dontUseGui()

Specified by:

dontUseGui in interface Visibility

public void okToUseGui()

Specified by:

okToUseGui in interface Visibility

public boolean avoidingGui()

Specified by:

avoidingGui in interface Visibility

Returns:

is this instance avoiding using its GUI?

See Also:

• Visibility

public boolean isSerializing()

Returns:

true if this BeanContext is currently being serialized, otherwise false

protected Iterator<BeanContextSupport.BCSChild> bcsChildren()

Returns:

an iterator for all the current BCSChild values

protected void bcsPreSerializationHook(ObjectOutputStream oos) throws IOException

Parameters:

oos - the ObjectOutputStream to use during serialization

Throws:

IOException - if serialization failed

protected void bcsPreDeserializationHook(ObjectInputStream ois) throws IOException, ClassNotFoundException

Parameters:

ois - the ObjectInputStream to use during deserialization

Throws:

IOException - if deserialization failed

ClassNotFoundException - if needed classes are not found

protected void childDeserializedHook(Object child, BeanContextSupport.BCSChild bcsc)

Parameters:

child - the newly deserialized child

bcsc - the newly deserialized BCSChild

protected final void serialize(ObjectOutputStream oos, Collection<?> coll) throws IOException

Parameters:

oos - the ObjectOutputStream to use during serialization

coll - the Collection to serialize

Throws:

IOException - if serialization failed

protected final void deserialize(ObjectInputStream ois, Collection coll) throws IOException, ClassNotFoundException

Parameters:

ois - the ObjectInputStream to use

coll - the Collection

Throws:

IOException - if deserialization failed

ClassNotFoundException - if needed classes are not found

public final void writeChildren(ObjectOutputStream oos) throws IOException

Parameters:

oos - the ObjectOutputStream to use during serialization

Throws:

IOException - if serialization failed

public final void readChildren(ObjectInputStream ois) throws IOException, ClassNotFoundException

Parameters:

ois - the ObjectInputStream to use

Throws:

IOException - if deserialization failed

ClassNotFoundException - if needed classes are not found

public void vetoableChange(PropertyChangeEvent pce) throws PropertyVetoException

Specified by:

vetoableChange in interface VetoableChangeListener

Parameters:

pce - a PropertyChangeEvent object describing the event source and the property that has changed.

Throws:

PropertyVetoException - if the recipient wishes the property change to be rolled back.

public void propertyChange(PropertyChangeEvent pce)

Specified by:

propertyChange in interface PropertyChangeListener

Parameters:

pce - A PropertyChangeEvent object describing the event source and the property that has changed.

protected boolean validatePendingAdd(Object targetChild)

Parameters:

targetChild - the child to create the Child on behalf of

Returns:

true iff the child may be added to this BeanContext, otherwise false.

protected boolean validatePendingRemove(Object targetChild)

Parameters:

targetChild - the child to create the Child on behalf of

Returns:

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

protected void childJustAddedHook(Object child, BeanContextSupport.BCSChild bcsc)

Parameters:

child - the child

bcsc - the BCSChild

protected void childJustRemovedHook(Object child, BeanContextSupport.BCSChild bcsc)

Parameters:

child - the child

bcsc - the BCSChild

protected static final Visibility getChildVisibility(Object child)

Parameters:

child - the specified child

Returns:

the Component (if any) associated with the specified child.

protected static final Serializable getChildSerializable(Object child)

Parameters:

child - the specified child

Returns:

the Serializable (if any) associated with the specified Child

protected static final PropertyChangeListener getChildPropertyChangeListener(Object child)

Parameters:

child - the specified child

Returns:

the PropertyChangeListener (if any) of the specified child

protected static final VetoableChangeListener getChildVetoableChangeListener(Object child)

Parameters:

child - the specified child

Returns:

the VetoableChangeListener (if any) of the specified child

protected static final BeanContextMembershipListener getChildBeanContextMembershipListener(Object child)

Parameters:

child - the specified child

Returns:

the BeanContextMembershipListener (if any) of the specified child

protected static final BeanContextChild getChildBeanContextChild(Object child)

Parameters:

child - the specified child

Returns:

the BeanContextChild (if any) of the specified child

Throws:

IllegalArgumentException - if child implements both BeanContextChild and BeanContextProxy

protected final void fireChildrenAdded(BeanContextMembershipEvent bcme)

Parameters:

bcme - the event to fire

protected final void fireChildrenRemoved(BeanContextMembershipEvent bcme)

Parameters:

bcme - the event to fire

protected void initialize()

protected final Object[] copyChildren()

Returns:

a copy of the current nested children

protected static final boolean classEquals(Class<?> first, Class<?> second)

Parameters:

first - the first object

second - the second object

Returns:

true if equal, false if not