W3cubDocs

Class BeanContextMembershipEvent

java.lang.Object

java.util.EventObject

java.beans.beancontext.BeanContextEvent

java.beans.beancontext.BeanContextMembershipEvent

All 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:

Field Summary

Modifier and Type	Field	Description
`protected Collection`	`children`	The list of children affected by this event notification.

Fields declared in class java.beans.beancontext.BeanContextEvent

propagatedFrom

Fields declared in class java.util.EventObject

source

Constructor Summary

Constructor	Description
`BeanContextMembershipEvent(BeanContext bc, Object[] changes)`	Construct a BeanContextMembershipEvent
`BeanContextMembershipEvent(BeanContext bc, Collection changes)`	Construct a BeanContextMembershipEvent

Method Summary

Modifier and Type	Method	Description
`boolean`	`contains(Object child)`	Is the child specified affected by the event?
`Iterator`	`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 declared in class java.beans.beancontext.BeanContextEvent

getBeanContext, getPropagatedFrom, isPropagated, setPropagatedFrom

Methods declared in class java.util.EventObject

getSource, toString

Methods declared in class java.lang.Object

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

Field Details

children

protected Collection children

The list of children affected by this event notification.

Constructor Details

BeanContextMembershipEvent

public BeanContextMembershipEvent(BeanContext bc, Collection changes)

Construct a BeanContextMembershipEvent

Parameters:: bc - The BeanContext source; changes - The Children affected
Throws:: NullPointerException - if changes is null

BeanContextMembershipEvent

public BeanContextMembershipEvent(BeanContext bc, Object[] changes)

Construct a BeanContextMembershipEvent

Parameters:: bc - The BeanContext source; changes - The Children effected
Throws:: NullPointerException - if changes associated with this event are null.

Method Details

size

public int size()

Gets the number of children affected by the notification.

Returns:: the number of children affected by the notification

contains

public boolean contains(Object child)

Is the child specified affected by the event?

Parameters:: child - the object to check for being affected
Returns:: true if affected, false if not

toArray

public Object[] toArray()

Gets the array of children affected by this event.

Returns:: the array of children affected

iterator

public Iterator iterator()

Gets the array of children affected by this event.

Returns:: the array of children effected

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/java/beans/beancontext/BeanContextMembershipEvent.html