no.digipost

Class DiggIO

java.lang.Object

no.digipost.DiggIO

public final class DiggIO
extends Object

IO-related utilities.

Method Summary

Modifier and Type	Method and Description
static <T extends AutoCloseable> Consumer<T>	autoClosing(ThrowingConsumer<T,? extends Exception> consumer) Wrap a consumer which processes an AutoCloseable (typically an InputStream or similar) into a new Consumer which will always close the AutoCloseable when the given consumer returns, successfully or throwing an exception.
static <T extends AutoCloseable,R> Function<T,R>	autoClosing(ThrowingFunction<T,R,? extends Exception> function) Wrap a function which yields a result from processing an AutoCloseable (typically an InputStream or similar) into a new Function which will always close the AutoCloseable when the given function returns, successfully or throwing an exception.
static InputStream	limit(InputStream inputStream, long maxBytesToRead, Supplier<? extends Exception> throwIfTooManyBytes) Limit the number of bytes to be read from an InputStream.

Methods inherited from class java.lang.Object

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

Method Detail

autoClosing

public static <T extends AutoCloseable> Consumer<T> autoClosing(ThrowingConsumer<T,? extends Exception> consumer)

Wrap a consumer which processes an AutoCloseable (typically an InputStream or similar) into a new Consumer which will always close the AutoCloseable when the given consumer returns, successfully or throwing an exception.

Parameters:

consumer - the ThrowingConsumer taking an AutoCloseable as argument.

Returns:

the Consumer which will handle closing of the passed AutoCloseable.

autoClosing

public static <T extends AutoCloseable,R> Function<T,R> autoClosing(ThrowingFunction<T,R,? extends Exception> function)

Wrap a function which yields a result from processing an AutoCloseable (typically an InputStream or similar) into a new Function which will always close the AutoCloseable when the given function returns, successfully or throwing an exception.

Parameters:

function - the ThrowingFunction taking an AutoCloseable as argument.

Returns:

the Function which will handle closing of the passed AutoCloseable.

limit

public static InputStream limit(InputStream inputStream,
                                long maxBytesToRead,
                                Supplier<? extends Exception> throwIfTooManyBytes)

Limit the number of bytes to be read from an InputStream. If the number of bytes exceeds the given threshold, an exception will be thrown.

Parameters:

inputStream - The InputStream to limit bytes to read from.

maxBytesToRead - The limit in bytes.

throwIfTooManyBytes - Supplier of exception to throw if more bytes are read than the max allowed. If the supplier returns a non-RuntimeException which is not an IOException, it will be wrapped in a RuntimeException.