sos.dated.util
Interface ListIterator

All Superinterfaces:

Iterator

public interface ListIterator

extends Iterator

A forward and reverse mechanism to step through and (possibly) alter a dated list.

Since:

1.0

See Also:

Iterator, DatedList

Method Summary

void	add(java.lang.Object value, java.util.Date from, java.util.Date to) Inserts the specified element into the underlying list for the specified date range (optional operation).
boolean	hasPrevious() Indicates if the iteration has a previous element.
int	nextIndex() Returns the index of the next element to be returned by next.
java.lang.Object	previous() Returns the previous element in the iteration.
int	previousIndex() Returns the index of the next element to be returned by previous.
void	set(java.lang.Object value, java.util.Date from, java.util.Date to) Replaces the element last returned by a call to next or previous with the specified element for the specified date range (optional operation).

Methods inherited from interface sos.dated.util.Iterator

hasNext, next, remove

Method Detail

add

public void add(java.lang.Object value,
                java.util.Date from,
                java.util.Date to)

Inserts the specified element into the underlying list for the specified date range (optional operation).

Parameters:

value - element to add to list

from - start of date range (inclusive) to add the element

to - end of date range (exclusive) to add the element

Throws:

java.lang.NullPointerException - if from or to is null

java.lang.IllegalArgumentException - if from does not precede to

hasPrevious

public boolean hasPrevious()

Indicates if the iteration has a previous element.

Returns:

true if this iterator will not throw an NoSuchElementException in its next call to previous

nextIndex

public int nextIndex()

Returns the index of the next element to be returned by next.

Returns:

the index of the next element to be returned by next.

previous

public java.lang.Object previous()

Returns the previous element in the iteration.

Returns:

the previous element in the iteration.

Throws:

java.util.ConcurrentModificationException - if the underlying list has unexpectly changed at the date of iteration

previousIndex

public int previousIndex()

Returns the index of the next element to be returned by previous.

Returns:

the index of the next element to be returned by previous.

set

public void set(java.lang.Object value,
                java.util.Date from,
                java.util.Date to)

Replaces the element last returned by a call to next or previous with the specified element for the specified date range (optional operation).

Parameters:

value - element to substitute for the element last returned by next or previous

from - start of date range (inclusive) to replace the element

to - end of date range (exclusive) to replace the element

Throws:

java.lang.UnsupportedOperationException - if this iterator does not support this operation

java.lang.NullPointerException - if from or to is null

java.lang.IllegalArgumentException - if from does not precede to

java.lang.IllegalStateException - if neither next nor previous has not been called or if remove or add has already been called since the last call to next or previous

java.lang.UnsupportedOperationException - if this iterator does not support the replacement of this element