Package org.apache.commons.collections.iterators

Class SingletonListIterator

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

  • Constructor Summary

    Constructors
    Constructor
    Description
    SingletonListIterator(Object object)
    Deprecated.
    Constructs a new SingletonListIterator.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    add(Object obj)
    Deprecated.
    Add always throws UnsupportedOperationException.
    boolean
    hasNext()
    Deprecated.
    Is another object available from the iterator?
    boolean
    hasPrevious()
    Deprecated.
    Is a previous object available from the iterator?
    Object
    next()
    Deprecated.
    Get the next object from the iterator.
    int
    nextIndex()
    Deprecated.
    Returns the index of the element that would be returned by a subsequent call to next.
    Object
    previous()
    Deprecated.
    Get the previous object from the iterator.
    int
    previousIndex()
    Deprecated.
    Returns the index of the element that would be returned by a subsequent call to previous.
    void
    remove()
    Deprecated.
    Remove the object from this iterator.
    void
    reset()
    Deprecated.
    Reset the iterator back to the start.
    void
    set(Object obj)
    Deprecated.
    Set sets the value of the singleton.

    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

    • SingletonListIterator

      public SingletonListIterator(Object object)
      Deprecated.
      Constructs a new SingletonListIterator.
      Parameters:
      object - the single object to return from the iterator

  • 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
      Specified by:
      hasNext in interface ListIterator
      Returns:
      true if the single object hasn't been returned yet

    • hasPrevious

      public boolean hasPrevious()
      Deprecated.
      Is a previous object available from the iterator?

      This returns true if the single object has been returned.

      Specified by:
      hasPrevious in interface ListIterator
      Returns:
      true if the single object has been returned

    • nextIndex

      public int nextIndex()
      Deprecated.
      Returns the index of the element that would be returned by a subsequent call to next.
      Specified by:
      nextIndex in interface ListIterator
      Returns:
      0 or 1 depending on current state.

    • previousIndex

      public int previousIndex()
      Deprecated.
      Returns the index of the element that would be returned by a subsequent call to previous. A return value of -1 indicates that the iterator is currently at the start.
      Specified by:
      previousIndex in interface ListIterator
      Returns:
      0 or -1 depending on current state.

    • 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
      Specified by:
      next in interface ListIterator
      Returns:
      the single object
      Throws:
      NoSuchElementException - if the single object has already been returned

    • previous

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

      This returns the single object if it has been returned.

      Specified by:
      previous in interface ListIterator
      Returns:
      the single object
      Throws:
      NoSuchElementException - if the single object has not already been returned

    • remove

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

    • add

      public void add(Object obj)
      Deprecated.
      Add always throws UnsupportedOperationException.
      Specified by:
      add in interface ListIterator
      Throws:
      UnsupportedOperationException - always

    • set

      public void set(Object obj)
      Deprecated.
      Set sets the value of the singleton.
      Specified by:
      set in interface ListIterator
      Parameters:
      obj - the object to set
      Throws:
      IllegalStateException - if next has not been called or the object has been removed

    • reset

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