Package net.cscott.jutil

Class UnmodifiableIterator<E>

java.lang.Object

net.cscott.jutil.UnmodifiableIterator<E>

All Implemented Interfaces:

Iterator<E>

@Deprecated(since="2.0")
public abstract class UnmodifiableIterator<E>
extends Object
implements Iterator<E>

Deprecated.

Implement Iterator instead: its default remove() method throws UnsupportedOperationException. In place of proxy(Iterator), use Default.unmodifiableIterator(java.util.Iterator<? extends E>).

UnmodifiableIterator is an abstract superclass to save you the trouble of implementing the remove() method over and over again for those iterators which don't implement it. The name's a bit clunky, but fits with the JDK naming in Collections and etc.

Author:

C. Scott Ananian <cananian@alumni.princeton.edu>

Constructor Summary

Constructors

Constructor	Description
UnmodifiableIterator()	Deprecated.

Method Summary

Modifier and Type	Method	Description
abstract boolean	hasNext()	Deprecated. Returns true if the iteration has more elements.
abstract E	next()	Deprecated. Returns the next element in the iteration.
static <E> UnmodifiableIterator<E>	proxy(Iterator<E> it)	Deprecated. Create an UnmodifiableIterator from the given (potentailly modifiable) Iterator.
final void	remove()	Deprecated. Always throws an UnsupportedOperationException.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Iterator

forEachRemaining

Constructor Details

UnmodifiableIterator

public UnmodifiableIterator()

Deprecated.

Method Details

proxy

public static <E> UnmodifiableIterator<E> proxy(Iterator<E> it)

Deprecated.

Create an UnmodifiableIterator from the given (potentailly modifiable) Iterator.

Since:

1.3

hasNext

public abstract boolean hasNext()

Deprecated.

Returns true if the iteration has more elements.

Specified by:

hasNext in interface Iterator<E>

Returns:

true if the iterator has more elements.

next

public abstract E next()

Deprecated.

Returns the next element in the iteration.

Specified by:

next in interface Iterator<E>

Throws:

NoSuchElementException - iteration has no more elements.

remove

public final void remove()

Deprecated.

Always throws an UnsupportedOperationException.

Specified by:

remove in interface Iterator<E>

Throws:

UnsupportedOperationException - always.