org.mortbay.component
Class Container

java.lang.Object
  org.mortbay.component.Container

public class Container
extends Object

Container. This class allows a containment events to be generated from update methods. The style of usage is:

   public void setFoo(Foo foo)
   {
       getContainer().update(this,this.foo,foo,"foo");
       this.foo=foo;
   }
   
   public void setBars(Bar[] bars)
   {
       getContainer().update(this,this.bars,bars,"bar");
       this.bars=bars;
   }
 

Author:

gregw

Nested Class Summary

static interface	Container.Listener Listener.
static class	Container.Relationship A Container event.

Constructor Summary

Container()

Method Summary

void	addBean(Object obj)
void	addEventListener(Container.Listener listener)
void	removeBean(Object obj)
void	removeEventListener(Container.Listener listener)
void	update(Object parent, Object[] oldChildren, Object[] children, String relationship) Update multiple parent to child relationship.
void	update(Object parent, Object[] oldChildren, Object[] children, String relationship, boolean addRemove) Update multiple parent to child relationship.
void	update(Object parent, Object oldChild, Object child, String relationship) Update single parent to child relationship.
void	update(Object parent, Object oldChild, Object child, String relationship, boolean addRemove) Update single parent to child relationship.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Container

public Container()

Method Detail

addEventListener

public void addEventListener(Container.Listener listener)

removeEventListener

public void removeEventListener(Container.Listener listener)

update

public void update(Object parent,
                   Object oldChild,
                   Object child,
                   String relationship)

Update single parent to child relationship.

Parameters:

parent - The parent of the child.

oldChild - The previous value of the child. If this is non null and differs from child, then a remove event is generated.

child - The current child. If this is non null and differs from oldChild, then an add event is generated.

relationship - The name of the relationship

update

public void update(Object parent,
                   Object oldChild,
                   Object child,
                   String relationship,
                   boolean addRemove)

Update single parent to child relationship.

Parameters:

parent - The parent of the child.

oldChild - The previous value of the child. If this is non null and differs from child, then a remove event is generated.

child - The current child. If this is non null and differs from oldChild, then an add event is generated.

relationship - The name of the relationship

addRemoveBean - If true add/remove is called for the new/old children as well as the relationships

update

public void update(Object parent,
                   Object[] oldChildren,
                   Object[] children,
                   String relationship)

Update multiple parent to child relationship.

Parameters:

parent - The parent of the child.

oldChildren - The previous array of children. A remove event is generated for any child in this array but not in the children array. This array is modified and children that remain in the new children array are nulled out of the old children array.

children - The current array of children. An add event is generated for any child in this array but not in the oldChildren array.

relationship - The name of the relationship

update

public void update(Object parent,
                   Object[] oldChildren,
                   Object[] children,
                   String relationship,
                   boolean addRemove)

Update multiple parent to child relationship.

Parameters:

parent - The parent of the child.

oldChildren - The previous array of children. A remove event is generated for any child in this array but not in the children array. This array is modified and children that remain in the new children array are nulled out of the old children array.

children - The current array of children. An add event is generated for any child in this array but not in the oldChildren array.

relationship - The name of the relationship

addRemoveBean - If true add/remove is called for the new/old children as well as the relationships

addBean

public void addBean(Object obj)

removeBean

public void removeBean(Object obj)