Package org.apache.commons.net.util

Class ListenerList<T extends java.util.EventListener>

  • Type Parameters:
    T - the type of elements tracked by this list.
    All Implemented Interfaces:
    java.io.Serializable, java.lang.Iterable<T>
    public class ListenerList<T extends java.util.EventListener>
extends java.lang.Object
implements java.io.Serializable, java.lang.Iterable<T>
    A list of event listeners.
    See Also:
    Serialized Form

    • Field Summary

      Fields 
      Modifier and Type Field Description
      private java.util.concurrent.CopyOnWriteArrayList<T> listeners
      The thread-safe list of listeners.
      private static long serialVersionUID  

    • Constructor Summary

      Constructors 
      Constructor Description
      ListenerList()
      Constructs a new instance.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void addListener​(T listener)
      Adds the given listener to the end of this list.
      int getListenerCount()
      Gets the number of elements in this list.
      boolean isEmpty()
      Tests whether if this listener list is empty.
      java.util.Iterator<T> iterator()
      Return an Iterator for the EventListener instances.
      private void readObject​(java.io.ObjectInputStream ignored)
      Throws UnsupportedOperationException.
      void removeListener​(T listener)
      Removes the first occurrence of the specified listener from this list, if it is present.
      private void writeObject​(java.io.ObjectOutputStream ignored)
      Always throws UnsupportedOperationException.

      • Methods inherited from class java.lang.Object

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

      • Methods inherited from interface java.lang.Iterable

        forEach, spliterator

    • Field Detail

      • listeners

        private final java.util.concurrent.CopyOnWriteArrayList<T extends java.util.EventListener> listeners
        The thread-safe list of listeners.

    • Constructor Detail

      • ListenerList

        public ListenerList()
        Constructs a new instance.

    • Method Detail

      • addListener

        public void addListener​(T listener)
        Adds the given listener to the end of this list.
        Parameters:
        listener - A listener.

      • getListenerCount

        public int getListenerCount()
        Gets the number of elements in this list.
        Returns:
        the number of elements in this list

      • isEmpty

        public boolean isEmpty()
        Tests whether if this listener list is empty.
        Returns:
        whether if this listener list is empty.
        Since:
        3.12.0

      • iterator

        public java.util.Iterator<T> iterator()
        Return an Iterator for the EventListener instances.
        Specified by:
        iterator in interface java.lang.Iterable<T extends java.util.EventListener>
        Returns:
        an Iterator for the EventListener instances
        Since:
        2.0 TODO Check that this is a good defensive strategy

      • readObject

        private void readObject​(java.io.ObjectInputStream ignored)
        Throws UnsupportedOperationException.
        Parameters:
        ignored - Ignore.

      • removeListener

        public void removeListener​(T listener)
        Removes the first occurrence of the specified listener from this list, if it is present.
        Parameters:
        listener - listener to be removed from this list, if present.

      • writeObject

        private void writeObject​(java.io.ObjectOutputStream ignored)
        Always throws UnsupportedOperationException.
        Parameters:
        ignored - ignored.
        Throws:
        java.lang.UnsupportedOperationException - Always thrown.