• 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:
    BeanContext, BeanContextEvent, BeanContextMembershipListener, Serialized Form

    • Field Detail

      • children

        protected Collection children

        The list of children affected by this event notification.

    • Constructor Detail

      • BeanContextMembershipEvent

        public BeanContextMembershipEvent​(BeanContext bc,
                                  Collection changes)

        Contruct a BeanContextMembershipEvent

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

      • 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.

    • Method Detail

      • 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