BeanContextMembershipEvent (Java SE 23 & JDK 23)
Description: declaration: module: java.desktop, package: java.beans.beancontext, class: BeanContextMembershipEvent
Keywords: java.beans.beancontext.BeanContextMembershipEvent class

# Class BeanContextMembershipEvent

java.lang.Object
java.util.EventObject
java.beans.beancontext.BeanContextEvent
java.beans.beancontext.BeanContextMembershipEvent

All Implemented Interfaces:
  `Serializable`

@Deprecated(since="23", forRemoval=true) public class BeanContextMembershipEvent extends BeanContextEvent
Deprecated, for removal: This API element is subject to removal in a future version.
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

  Fields
  Modifier and Type
  Field
  Description
  `protected Collection`
  `children`
  Deprecated, for removal: This API element is subject to removal in a future version.
  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

  Constructors
  Constructor
  Description
  `BeanContextMembershipEvent(BeanContext bc, Object[] changes)`
  Deprecated, for removal: This API element is subject to removal in a future version.
  Construct a BeanContextMembershipEvent
  `BeanContextMembershipEvent(BeanContext bc, Collection changes)`
  Deprecated, for removal: This API element is subject to removal in a future version.
  Construct a BeanContextMembershipEvent

- ## Method Summary

  Modifier and Type
  Method
  Description
  `boolean`
  `contains(Object child)`
  Deprecated, for removal: This API element is subject to removal in a future version.
  Is the child specified affected by the event?
  `Iterator`
  `iterator()`
  Deprecated, for removal: This API element is subject to removal in a future version.
  Gets the array of children affected by this event.
  `int`
  `size()`
  Deprecated, for removal: This API element is subject to removal in a future version.
  Gets the number of children affected by the notification.
  `Object[]`
  `toArray()`
  Deprecated, for removal: This API element is subject to removal in a future version.
  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
    Deprecated, for removal: This API element is subject to removal in a future version.
    The list of children affected by this event notification.

- ## Constructor Details

  - ### BeanContextMembershipEvent

    public BeanContextMembershipEvent(BeanContext bc, Collection changes)
    Deprecated, for removal: This API element is subject to removal in a future version.
    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)
    Deprecated, for removal: This API element is subject to removal in a future version.
    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()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Gets the number of children affected by the notification.
    Returns:
      the number of children affected by the notification

  - ### contains

    public boolean contains(Object child)
    Deprecated, for removal: This API element is subject to removal in a future version.
    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()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Gets the array of children affected by this event.
    Returns:
      the array of children affected

  - ### iterator

    public Iterator iterator()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Gets the array of children affected by this event.
    Returns:
      the array of children effected