Package org.apache.commons.collections.iterators

Class ListIteratorWrapper

java.lang.Object

org.apache.commons.collections.iterators.ListIteratorWrapper

All Implemented Interfaces:

Iterator, ListIterator, ResettableIterator, ResettableListIterator

@Deprecated(since="2021-04-30")
public class ListIteratorWrapper
extends Object
implements 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.

Converts an iterator into a list iterator by caching the returned entries.

The ListIterator interface has additional useful methods for navigation - previous() and the index methods. This class allows a regular Iterator to behave as a ListIterator. It achieves this by building a list internally of as the underlying iterator is traversed.

The optional operations of ListIterator are not supported.

This class implements ResettableListIterator from Commons Collections 3.2.

Since:

Commons Collections 2.1

Constructor Summary

Constructors

Constructor	Description
ListIteratorWrapper(Iterator iterator)	Deprecated. Constructs a new ListIteratorWrapper that will wrap the given iterator.

Method Summary

Modifier and Type	Method	Description
void	add(Object obj)	Deprecated. Throws UnsupportedOperationException.
boolean	hasNext()	Deprecated. Returns true if there are more elements in the iterator.
boolean	hasPrevious()	Deprecated. Returns true if there are previous elements in the iterator.
Object	next()	Deprecated. Returns the next element from the iterator.
int	nextIndex()	Deprecated. Returns in the index of the next element.
Object	previous()	Deprecated. Returns the the previous element.
int	previousIndex()	Deprecated. Returns the index of the previous element.
void	remove()	Deprecated. Throws UnsupportedOperationException.
void	reset()	Deprecated. Resets this iterator back to the position at which the iterator was created.
void	set(Object obj)	Deprecated. Throws UnsupportedOperationException.

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

ListIteratorWrapper

public ListIteratorWrapper(Iterator iterator)

Deprecated.

Constructs a new ListIteratorWrapper that will wrap the given iterator.

Parameters:

iterator - the iterator to wrap

Throws:

NullPointerException - if the iterator is null

Method Details

add

public void add(Object obj)
         throws UnsupportedOperationException

Deprecated.

Throws UnsupportedOperationException.

Specified by:

add in interface ListIterator

Parameters:

obj - the object to add, ignored

Throws:

UnsupportedOperationException - always

hasNext

public boolean hasNext()

Deprecated.

Returns true if there are more elements in the iterator.

Specified by:

hasNext in interface Iterator

Specified by:

hasNext in interface ListIterator

Returns:

true if there are more elements

hasPrevious

public boolean hasPrevious()

Deprecated.

Returns true if there are previous elements in the iterator.

Specified by:

hasPrevious in interface ListIterator

Returns:

true if there are previous elements

next

public Object next()
            throws NoSuchElementException

Deprecated.

Returns the next element from the iterator.

Specified by:

next in interface Iterator

Specified by:

next in interface ListIterator

Returns:

the next element from the iterator

Throws:

NoSuchElementException - if there are no more elements

nextIndex

public int nextIndex()

Deprecated.

Returns in the index of the next element.

Specified by:

nextIndex in interface ListIterator

Returns:

the index of the next element

previous

public Object previous()
                throws NoSuchElementException

Deprecated.

Returns the the previous element.

Specified by:

previous in interface ListIterator

Returns:

the previous element

Throws:

NoSuchElementException - if there are no previous elements

previousIndex

public int previousIndex()

Deprecated.

Returns the index of the previous element.

Specified by:

previousIndex in interface ListIterator

Returns:

the index of the previous element

remove

public void remove()
            throws UnsupportedOperationException

Deprecated.

Throws UnsupportedOperationException.

Specified by:

remove in interface Iterator

Specified by:

remove in interface ListIterator

Throws:

UnsupportedOperationException - always

set

public void set(Object obj)
         throws UnsupportedOperationException

Deprecated.

Throws UnsupportedOperationException.

Specified by:

set in interface ListIterator

Parameters:

obj - the object to set, ignored

Throws:

UnsupportedOperationException - always

reset

public void reset()

Deprecated.

Resets this iterator back to the position at which the iterator was created.

Specified by:

reset in interface ResettableIterator

Specified by:

reset in interface ResettableListIterator

Since:

Commons Collections 3.2