org.danilopianini.util.stream

Class Streams

java.lang.Object

org.danilopianini.util.stream.Streams

public final class Streams
extends Object

Complementary utilities for the Java 8 Stream library.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	Streams()

Method Summary

Modifier and Type	Method and Description
static Stream<Byte>	fileToByteStream(File in, Consumer<IOException> onFailure)
static Stream<Byte>	fileToByteStream(Path in, Consumer<IOException> onFailure)
static Stream<Byte>	fileToByteStream(URL in, Consumer<IOException> onFailure)
static <E> Stream<E>	flatten(E target, Function<? super E,? extends Stream<? extends E>> extractor) Flattens a recursive, tree-like, non circular data structure into a Stream.
static <T> Stream<T>	iteratorToStream(Iterator<T> in)

Methods inherited from class java.lang.Object

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

Constructor Detail

Streams

private Streams()

Method Detail

fileToByteStream

public static Stream<Byte> fileToByteStream(File in,
                                            Consumer<IOException> onFailure)

Parameters:

in - input resource

onFailure - executed in case of IOException

Returns:

a Stream reading through the bytes of the file

fileToByteStream

public static Stream<Byte> fileToByteStream(Path in,
                                            Consumer<IOException> onFailure)

Parameters:

in - input resource

onFailure - executed in case of IOException

Returns:

a Stream reading through the bytes of the file

fileToByteStream

public static Stream<Byte> fileToByteStream(URL in,
                                            Consumer<IOException> onFailure)

Parameters:

in - input resource

onFailure - executed in case of IOException

Returns:

a Stream reading through the bytes of the file

flatten

public static <E> Stream<E> flatten(E target,
                                    Function<? super E,? extends Stream<? extends E>> extractor)

Flattens a recursive, tree-like, non circular data structure into a Stream.

Type Parameters:

E - the type of object

Parameters:

target - the root element of the structure

extractor - the function that maps a node of the structure to a stream of its children

Returns:

a Stream walking through the data structure

iteratorToStream

public static <T> Stream<T> iteratorToStream(Iterator<T> in)

Type Parameters:

T - iterator type

Parameters:

in - the input Iterator

Returns:

a Stream wrapper onto it