org.apache.commons.collections.list

Class CursorableLinkedList.Cursor

java.lang.Object

org.apache.commons.collections.list.AbstractLinkedList.LinkedListIterator

org.apache.commons.collections.list.CursorableLinkedList.Cursor

All Implemented Interfaces:

java.util.Iterator, java.util.ListIterator, OrderedIterator

Enclosing class:

CursorableLinkedList

public static class CursorableLinkedList.Cursor
extends AbstractLinkedList.LinkedListIterator

An extended ListIterator that allows concurrent changes to the underlying list.

Method Summary

Modifier and Type	Method and Description
void	add(java.lang.Object obj) Adds an object to the list.
void	close() Mark this cursor as no longer being needed.
int	nextIndex() Gets the index of the next element to be returned.
void	remove() Removes the item last returned by this iterator.

Methods inherited from class org.apache.commons.collections.list.AbstractLinkedList.LinkedListIterator

hasNext, hasPrevious, next, previous, previousIndex, set

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Iterator

forEachRemaining

Method Detail

remove

public void remove()

Removes the item last returned by this iterator.

There may have been subsequent alterations to the list since you obtained this item, however you can still remove it. You can even remove it if the item is no longer in the main list. However, you can't call this method on the same iterator more than once without calling next() or previous().

Specified by:

remove in interface java.util.Iterator

Specified by:

remove in interface java.util.ListIterator

Overrides:

remove in class AbstractLinkedList.LinkedListIterator

Throws:

java.lang.IllegalStateException - if there is no item to remove

add

public void add(java.lang.Object obj)

Adds an object to the list. The object added here will be the new 'previous' in the iterator.

Specified by:

add in interface java.util.ListIterator

Overrides:

add in class AbstractLinkedList.LinkedListIterator

Parameters:

obj - the object to add

nextIndex

public int nextIndex()

Gets the index of the next element to be returned.

Specified by:

nextIndex in interface java.util.ListIterator

Overrides:

nextIndex in class AbstractLinkedList.LinkedListIterator

Returns:

the next index

close

public void close()

Mark this cursor as no longer being needed. Any resources associated with this cursor are immediately released. In previous versions of this class, it was mandatory to close all cursor objects to avoid memory leaks. It is no longer necessary to call this close method; an instance of this class can now be treated exactly like a normal iterator.