org.apache.jena.util.iterator

Class WrappedIterator<T>

java.lang.Object

org.apache.jena.util.iterator.NiceIterator<T>

org.apache.jena.util.iterator.WrappedIterator<T>

All Implemented Interfaces:

Iterator<T>, ClosableIterator<T>, ExtendedIterator<T>

Direct Known Subclasses:

FilterIterator, NodeIteratorImpl, NsIteratorImpl, RandomOrderIterator, ResIteratorImpl, RSIteratorImpl, StmtIteratorImpl, TrackingTripleIterator

public class WrappedIterator<T>
extends NiceIterator<T>

a WrappedIterator is an ExtendedIterator wrapping around a plain (or presented as plain) Iterator. The wrapping allows the usual extended operations (filtering, concatenating) to be done on an Iterator derived from some other source.

Method Summary

Modifier and Type	Method and Description
void	close() close: defer to the base, iff it is closable
static void	close(Iterator<?> it) if it is a Closableiterator, close it.
static <T> ExtendedIterator<T>	create(Iterator<T> it) Answer an ExtendedIterator returning the elements of it.
static <T> ExtendedIterator<T>	createIteratorIterator(Iterator<Iterator<T>> it) Given an Iterator that returns Iterator's, this creates an Iterator over the next level values.
static <T> WrappedIterator<T>	createNoRemove(Iterator<T> it) Answer an ExtendedIterator wrapped round it which does not permit .remove() even if it does.
Iterator<? extends T>	forTestingOnly_getBase()
boolean	hasNext() hasNext: defer to the base iterator
T	next() next: defer to the base iterator
void	remove() if .remove() is allowed, delegate to the base iterator's .remove; otherwise, throw an UnsupportedOperationException.

Methods inherited from class org.apache.jena.util.iterator.NiceIterator

andThen, andThen, asList, asSet, emptyIterator, filterDrop, filterKeep, mapWith, removeNext, toList, toSet

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.jena.util.iterator.ExtendedIterator

nextOptional

Methods inherited from interface java.util.Iterator

forEachRemaining

Method Detail

create

public static <T> ExtendedIterator<T> create(Iterator<T> it)

Answer an ExtendedIterator returning the elements of it. If it is itself an ExtendedIterator, return that; otherwise wrap it.

createNoRemove

public static <T> WrappedIterator<T> createNoRemove(Iterator<T> it)

Answer an ExtendedIterator wrapped round it which does not permit .remove() even if it does.

createIteratorIterator

public static <T> ExtendedIterator<T> createIteratorIterator(Iterator<Iterator<T>> it)

Given an Iterator that returns Iterator's, this creates an Iterator over the next level values. Similar to list splicing in lisp.

forTestingOnly_getBase

public Iterator<? extends T> forTestingOnly_getBase()

hasNext

public boolean hasNext()

hasNext: defer to the base iterator

Specified by:

hasNext in interface Iterator<T>

Overrides:

hasNext in class NiceIterator<T>

next

public T next()

next: defer to the base iterator

Specified by:

next in interface Iterator<T>

Overrides:

next in class NiceIterator<T>

remove

public void remove()

if .remove() is allowed, delegate to the base iterator's .remove; otherwise, throw an UnsupportedOperationException.

Specified by:

remove in interface Iterator<T>

Overrides:

remove in class NiceIterator<T>

close

public void close()

close: defer to the base, iff it is closable

Specified by:

close in interface ClosableIterator<T>

Overrides:

close in class NiceIterator<T>

close

public static void close(Iterator<?> it)

if it is a Closableiterator, close it. Abstracts away from tests [that were] scattered through the code.