Class Iterations
- java.lang.Object
-
- org.eclipse.rdf4j.common.iteration.Iterations
-
- Direct Known Subclasses:
QueryResults
public class Iterations extends Object
This class consists exclusively of static methods that operate on or return Iterations. It is the Iteration-equivalent of java.util.Collections.
-
-
Constructor Summary
Constructors Constructor Description Iterations()
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static <E,X extends Exception,C extends Collection<E>>
CaddAll(Iteration<? extends E,X> iter, C collection)Adds all elements from the supplied Iteration to the specified collection.static <E,X extends Exception>
List<E>asList(Iteration<? extends E,X> iter)Get a List containing all elements obtained from the specified Iteration.static <E,X extends Exception>
Set<E>asSet(Iteration<? extends E,? extends X> arg2, Supplier<Set<E>> setMaker)Get a Set containing all elements obtained from the specified Iteration.static <E,X extends Exception>
Set<E>asSet(Iteration<? extends E,X> iter)Get a Set containing all elements obtained from the specified Iteration.static <X extends Exception>
voidcloseCloseable(Iteration<?,X> iter)Closes the supplied Iteration if it is an instance ofCloseableIteration, otherwise the request is ignored.static <T> Stream<T>stream(Iteration<T,? extends Exception> iteration)static <X extends Exception>
StringtoString(Iteration<?,X> iter, String separator)Converts an Iteration to a string by concatenating all of the string representations of objects in the Iteration, divided by a separator.static <X extends Exception>
voidtoString(Iteration<?,X> iter, String separator, StringBuilder sb)Converts an Iteration to a string by concatenating all of the string representations of objects in the Iteration, divided by a separator.
-
-
-
Method Detail
-
asList
public static <E,X extends Exception> List<E> asList(Iteration<? extends E,X> iter) throws X extends Exception
Get a List containing all elements obtained from the specified Iteration.- Parameters:
iter- the Iteration to get the elements from- Returns:
- a List containing all elements obtained from the specified Iteration.
- Throws:
X extends Exception
-
asSet
public static <E,X extends Exception> Set<E> asSet(Iteration<? extends E,X> iter) throws X extends Exception
Get a Set containing all elements obtained from the specified Iteration.- Parameters:
iter- the Iteration to get the elements from- Returns:
- a Set containing all elements obtained from the specified Iteration.
- Throws:
X extends Exception
-
addAll
public static <E,X extends Exception,C extends Collection<E>> C addAll(Iteration<? extends E,X> iter, C collection) throws X extends Exception
Adds all elements from the supplied Iteration to the specified collection. If the supplied Iteration is an instance ofCloseableIterationit is automatically closed after consumption.- Parameters:
iter- An Iteration containing elements to add to the container. If the Iteration is an instance ofCloseableIterationit is automatically closed after consumption.collection- The collection to add the elements to.- Returns:
- The collection object that was supplied to this method.
- Throws:
X extends Exception
-
stream
public static <T> Stream<T> stream(Iteration<T,? extends Exception> iteration)
Get a sequentialStreamwith the suppliedIterationas its source. If the source iteration is aCloseableIteration, it will be automatically closed by the stream when done. Any checked exceptions thrown at any point during stream processing will be propagated wrapped in aRuntimeException.
-
closeCloseable
public static <X extends Exception> void closeCloseable(Iteration<?,X> iter) throws X extends Exception
Closes the supplied Iteration if it is an instance ofCloseableIteration, otherwise the request is ignored.- Parameters:
iter- The Iteration that should be closed.- Throws:
X extends Exception
-
toString
public static <X extends Exception> String toString(Iteration<?,X> iter, String separator) throws X extends Exception
Converts an Iteration to a string by concatenating all of the string representations of objects in the Iteration, divided by a separator.- Parameters:
iter- An Iteration over arbitrary objects that are expected to implementObject.toString().separator- The separator to insert between the object strings.- Returns:
- A String representation of the objects provided by the supplied Iteration.
- Throws:
X extends Exception
-
toString
public static <X extends Exception> void toString(Iteration<?,X> iter, String separator, StringBuilder sb) throws X extends Exception
Converts an Iteration to a string by concatenating all of the string representations of objects in the Iteration, divided by a separator.- Parameters:
iter- An Iteration over arbitrary objects that are expected to implementObject.toString().separator- The separator to insert between the object strings.sb- A StringBuilder to append the Iteration string to.- Throws:
X extends Exception
-
asSet
public static <E,X extends Exception> Set<E> asSet(Iteration<? extends E,? extends X> arg2, Supplier<Set<E>> setMaker) throws X extends Exception
Get a Set containing all elements obtained from the specified Iteration.- Parameters:
iter- the Iteration to get the elements fromsetMaker- the Supplier that constructs a new set- Returns:
- a Set containing all elements obtained from the specified Iteration.
- Throws:
X extends Exception
-
-