FileDocCategorySizeDatePackage
BeanContextMembershipEvent.javaAPI DocJava SE 5 API3322Fri Aug 26 14:56:58 BST 2005java.beans.beancontext

BeanContextMembershipEvent

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.
author
Laurence P. G. Cable
version
1.15
since
1.2
see
java.beans.beancontext.BeanContext
see
java.beans.beancontext.BeanContextEvent
see
java.beans.beancontext.BeanContextMembershipListener

Fields Summary
protected Collection
children
The list of children affected by this event notification.
Constructors Summary
public BeanContextMembershipEvent(BeanContext bc, Collection changes)
Contruct a BeanContextMembershipEvent

param
bc The BeanContext source
param
changes The Children affected
throws
NullPointerException if changes is null

	super(bc);

	if (changes == null) throw new NullPointerException(
	    "BeanContextMembershipEvent constructor:  changes is null.");

	children = changes;
    
public BeanContextMembershipEvent(BeanContext bc, Object[] changes)
Contruct a BeanContextMembershipEvent

param
bc The BeanContext source
param
changes The Children effected
exception
NullPointerException if changes associated with this event are null.

	super(bc);

	if (changes == null) throw new NullPointerException(
	    "BeanContextMembershipEvent:  changes is null.");

	children = Arrays.asList(changes);
    
Methods Summary
public booleancontains(java.lang.Object child)
Is the child specified affected by the event?

return
true if affected, false if not

	return children.contains(child);
    
public java.util.Iteratoriterator()
Gets the array of children affected by this event.

return
the array of children effected

 return children.iterator(); 
public intsize()
Gets the number of children affected by the notification.

return
the number of children affected by the notification

 return children.size(); 
public java.lang.Object[]toArray()
Gets the array of children affected by this event.

return
the array of children affected

 return children.toArray();