Package org.apache.commons.collections.iterators

Class EnumerationIterator

java.lang.Object
org.apache.commons.collections.iterators.EnumerationIterator
All Implemented Interfaces:
Iterator
@Deprecated(since="2021-04-30") public class EnumerationIterator extends Object implements Iterator
Deprecated.
Apache Commons Collections version 3.x is being deprecated from AEMaaCS. The upgraded version 4.4 of Commons Collections is already included as replacement. Customers are advised to upgrade to this version of the library. Please note: the package name was changed to org.apache.commons.collections4. Further note that there are AEM APIs currently exposing the old collections classes; these will be updated in upcoming releases.
Adapter to make Enumeration instances appear to be Iterator instances.
Since:
Commons Collections 1.0

  • Constructor Details

    • EnumerationIterator

      public EnumerationIterator()
      Deprecated.
      Constructs a new EnumerationIterator that will not function until setEnumeration(Enumeration) is called.

    • EnumerationIterator

      public EnumerationIterator(Enumeration enumeration)
      Deprecated.
      Constructs a new EnumerationIterator that provides an iterator view of the given enumeration.
      Parameters:
      enumeration - the enumeration to use

    • EnumerationIterator

      public EnumerationIterator(Enumeration enumeration, Collection collection)
      Deprecated.
      Constructs a new EnumerationIterator that will remove elements from the specified collection.
      Parameters:
      enumeration - the enumeration to use
      collection - the collection to remove elements form

  • Method Details

    • hasNext

      public boolean hasNext()
      Deprecated.
      Returns true if the underlying enumeration has more elements.
      Specified by:
      hasNext in interface Iterator
      Returns:
      true if the underlying enumeration has more elements
      Throws:
      NullPointerException - if the underlying enumeration is null

    • next

      public Object next()
      Deprecated.
      Returns the next object from the enumeration.
      Specified by:
      next in interface Iterator
      Returns:
      the next object from the enumeration
      Throws:
      NullPointerException - if the enumeration is null

    • remove

      public void remove()
      Deprecated.
      Removes the last retrieved element if a collection is attached.

      Functions if an associated Collection is known. If so, the first occurrence of the last returned object from this iterator will be removed from the collection.

      Specified by:
      remove in interface Iterator
      Throws:
      IllegalStateException - next() not called.
      UnsupportedOperationException - if no associated collection

    • getEnumeration

      public Enumeration getEnumeration()
      Deprecated.
      Returns the underlying enumeration.
      Returns:
      the underlying enumeration

    • setEnumeration

      public void setEnumeration(Enumeration enumeration)
      Deprecated.
      Sets the underlying enumeration.
      Parameters:
      enumeration - the new underlying enumeration