com.complexible.common.openrdf.util

Class AdunaIterations

java.lang.Object

com.complexible.common.openrdf.util.AdunaIterations

public final class AdunaIterations
extends Object

Utility methods for Aduna Iterations not already present in Iterations

Since:

0.4

Version:

4.0

Author:

Michael Grove

Method Summary

Modifier and Type	Method and Description
static void	closeQuietly(info.aduna.iteration.CloseableIteration<?,?> theCloseableIteration) Quietly close the iteration
static <T,E extends Exception> void	consume(info.aduna.iteration.CloseableIteration<T,E> theIter) Consume all of the results in the Iteration and then close it when iteration is complete.
static <T,E extends Exception> Optional<T>	singleResult(info.aduna.iteration.CloseableIteration<T,E> theIter) Return the first result of the iteration.
static <T,E extends Exception> long	size(info.aduna.iteration.CloseableIteration<T,E> theIter) Return the number of elements left in the Iteration.

Methods inherited from class java.lang.Object

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

Method Detail

closeQuietly

public static void closeQuietly(info.aduna.iteration.CloseableIteration<?,?> theCloseableIteration)

Quietly close the iteration

Parameters:

theCloseableIteration - the iteration to close

singleResult

public static <T,E extends Exception> Optional<T> singleResult(info.aduna.iteration.CloseableIteration<T,E> theIter)
                                                        throws E extends Exception

Return the first result of the iteration. If the Iteration is empty or null, the Optional will be absent. The Iteration is closed whether or not there is a result.

Parameters:

theIter - the iteration

Returns:

an Optional containing the first result of the iteration, if present.

Throws:

E

E extends Exception

consume

public static <T,E extends Exception> void consume(info.aduna.iteration.CloseableIteration<T,E> theIter)
                                            throws E extends Exception

Consume all of the results in the Iteration and then close it when iteration is complete.

Parameters:

theIter - the Iteration to consume

Throws:

E - if there is an error while consuming the results

E extends Exception

size

public static <T,E extends Exception> long size(info.aduna.iteration.CloseableIteration<T,E> theIter)
                                         throws E extends Exception

Return the number of elements left in the Iteration. The iteration is closed when complete.

Parameters:

theIter - the Iteration whose size should be computed

Returns:

the number of elements left

Throws:

E - if there is an error while iterating

E extends Exception