Package org.apache.commons.collections.iterators

Class SingletonIterator

java.lang.Object
org.apache.commons.collections.iterators.SingletonIterator
All Implemented Interfaces:
Iterator, ResettableIterator
@Deprecated(since="2021-04-30") public class SingletonIterator extends Object implements Iterator, ResettableIterator
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.
SingletonIterator is an Iterator over a single object instance.
Since:
Commons Collections 2.0

  • Constructor Summary

    Constructors
    Constructor
    Description
    SingletonIterator(Object object)
    Deprecated.
    Constructs a new SingletonIterator where remove is a permitted operation.
    SingletonIterator(Object object, boolean removeAllowed)
    Deprecated.
    Constructs a new SingletonIterator optionally choosing if remove is a permitted operation.

  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    hasNext()
    Deprecated.
    Is another object available from the iterator?
    Object
    next()
    Deprecated.
    Get the next object from the iterator.
    void
    remove()
    Deprecated.
    Remove the object from this iterator.
    void
    reset()
    Deprecated.
    Reset the iterator to the start.

    Methods inherited from class java.lang.Object

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

    Methods inherited from interface java.util.Iterator

    forEachRemaining

  • Constructor Details

    • SingletonIterator

      public SingletonIterator(Object object)
      Deprecated.
      Constructs a new SingletonIterator where remove is a permitted operation.
      Parameters:
      object - the single object to return from the iterator

    • SingletonIterator

      public SingletonIterator(Object object, boolean removeAllowed)
      Deprecated.
      Constructs a new SingletonIterator optionally choosing if remove is a permitted operation.
      Parameters:
      object - the single object to return from the iterator
      removeAllowed - true if remove is allowed
      Since:
      Commons Collections 3.1

  • Method Details

    • hasNext

      public boolean hasNext()
      Deprecated.
      Is another object available from the iterator?

      This returns true if the single object hasn't been returned yet.

      Specified by:
      hasNext in interface Iterator
      Returns:
      true if the single object hasn't been returned yet

    • next

      public Object next()
      Deprecated.
      Get the next object from the iterator.

      This returns the single object if it hasn't been returned yet.

      Specified by:
      next in interface Iterator
      Returns:
      the single object
      Throws:
      NoSuchElementException - if the single object has already been returned

    • remove

      public void remove()
      Deprecated.
      Remove the object from this iterator.
      Specified by:
      remove in interface Iterator
      Throws:
      IllegalStateException - if the next method has not yet been called, or the remove method has already been called after the last call to the next method.
      UnsupportedOperationException - if remove is not supported

    • reset

      public void reset()
      Deprecated.
      Reset the iterator to the start.
      Specified by:
      reset in interface ResettableIterator