org.apache.commons.collections.iterators

Class SingletonListIterator

java.lang.Object

org.apache.commons.collections.iterators.SingletonListIterator

All Implemented Interfaces:

java.util.Iterator, java.util.ListIterator

public class SingletonListIterator
extends java.lang.Object
implements java.util.ListIterator

SingletonIterator is an ListIterator over a single object instance.

Since:

2.1

Version:

$Id: SingletonListIterator.java,v 1.2.2.1 2004/05/22 12:14:04 scolebourne Exp $

Author:

Stephen Colebourne

Constructor Summary

Constructors

Constructor and Description
SingletonListIterator(java.lang.Object object) Constructs a new SingletonListIterator.

Method Summary

Methods

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

Methods inherited from class java.lang.Object

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

Constructor Detail

SingletonListIterator

public SingletonListIterator(java.lang.Object object)

Constructs a new SingletonListIterator.

Parameters:

object - the single object to return from the iterator

Method Detail

add

public void add(java.lang.Object obj)

Add always throws UnsupportedOperationException.

Specified by:

add in interface java.util.ListIterator

Throws:

java.lang.UnsupportedOperationException - always

hasNext

public boolean hasNext()

Is another object available from the iterator.

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

Specified by:

hasNext in interface java.util.Iterator

Specified by:

hasNext in interface java.util.ListIterator

Returns:

true if the single object hasn't been returned yet

hasPrevious

public boolean hasPrevious()

Is a previous object available from the iterator.

This returns true if the single object has been returned.

Specified by:

hasPrevious in interface java.util.ListIterator

Returns:

true if the single object has been returned

next

public java.lang.Object next()

Get the next object from the iterator.

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

Specified by:

next in interface java.util.Iterator

Specified by:

next in interface java.util.ListIterator

Returns:

the single object

Throws:

java.util.NoSuchElementException - if the single object has already been returned

nextIndex

public int nextIndex()

Returns the index of the element that would be returned by a subsequent call to next.

Specified by:

nextIndex in interface java.util.ListIterator

Returns:

0 or 1 depending on current state.

previous

public java.lang.Object previous()

Get the previous object from the iterator.

This returns the single object if it has been returned.

Specified by:

previous in interface java.util.ListIterator

Returns:

the single object

Throws:

java.util.NoSuchElementException - if the single object has not already been returned

previousIndex

public int previousIndex()

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 java.util.ListIterator

Returns:

0 or -1 depending on current state.

remove

public void remove()

Remove always throws UnsupportedOperationException.

Specified by:

remove in interface java.util.Iterator

Specified by:

remove in interface java.util.ListIterator

Throws:

java.lang.UnsupportedOperationException - always

set

public void set(java.lang.Object obj)

Set sets the value of the singleton.

Specified by:

set in interface java.util.ListIterator

Parameters:

obj - the object to set

Throws:

java.lang.IllegalStateException - if next has not been called