java.beans.beancontext

Class BeanContextMembershipEvent

Implemented Interfaces:
Serializable

public class BeanContextMembershipEvent
extends BeanContextEvent

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.
Since:
1.2
See Also:
BeanContext, BeanContextEvent, BeanContextMembershipListener, Serialized Form

Field Summary

protected Collection<E>
children
The list of children affected by this event notification.

Fields inherited from class java.beans.beancontext.BeanContextEvent

propagatedFrom

Fields inherited from class java.util.EventObject

source

Constructor Summary

BeanContextMembershipEvent(BeanContext bc, Object[] changes)
Contruct a BeanContextMembershipEvent
BeanContextMembershipEvent(BeanContext bc, Collection<E> changes)
Contruct a BeanContextMembershipEvent

Method Summary

boolean
contains(Object child)
Is the child specified affected by the event?
Iterator<E>
iterator()
Gets the array of children affected by this event.
int
size()
Gets the number of children affected by the notification.
Object[]
toArray()
Gets the array of children affected by this event.

Methods inherited from class java.beans.beancontext.BeanContextEvent

getBeanContext, getPropagatedFrom, isPropagated, setPropagatedFrom

Methods inherited from class java.util.EventObject

getSource, toString

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

children

protected Collection<E> children
The list of children affected by this event notification.

Constructor Details

BeanContextMembershipEvent

public BeanContextMembershipEvent(BeanContext bc,
                                  Object[] changes)
Contruct a BeanContextMembershipEvent
Parameters:
bc - The BeanContext source
changes - The Children effected
Throws:
NullPointerException - if changes associated with this event are null.

BeanContextMembershipEvent

public BeanContextMembershipEvent(BeanContext bc,
                                  Collection<E> changes)
Contruct a BeanContextMembershipEvent
Parameters:
bc - The BeanContext source
changes - The Children affected
Throws:
NullPointerException - if changes is null

Method Details

contains

public boolean contains(Object child)
Is the child specified affected by the event?
Returns:
true if affected, false if not

iterator

public Iterator<E> iterator()
Gets the array of children affected by this event.
Returns:
the array of children effected
Usages and Demos :

View More Examples of iterator()
   1: 
   2:   public void childrenAdded(BeanContextMembershipEvent bcme) {
   3:         ...
   4:     findAndInit(bcme.iterator());
   5:   }
   6:         ...
   7: 
   8:   public void childrenRemoved(BeanContextMembershipEvent bcme) {
   9:     Object someObj;
  10:         ...
  11:     Iterator it = bcme.iterator();

View Full Code Here

size

public int size()
Gets the number of children affected by the notification.
Returns:
the number of children affected by the notification

toArray

public Object[] toArray()
Gets the array of children affected by this event.
Returns:
the array of children affected