io.buybrain.util

Class Exceptions

java.lang.Object

io.buybrain.util.Exceptions

public class Exceptions
extends Object

Utility functions for dealing with checked exceptions in streams by wrapping them in runtime exceptions. The functions in this class are called `rethrow` and `rethrowR`. The R stands for Returning. The reason for this postfix is to deal with cases where the compiler cannot infer if a lambda function is meant to return or not, which would make a Function and Consumer ambiguous, as well as a Supplier and Runnable.

Constructor Summary

Constructors

Constructor and Description
Exceptions()

Method Summary

Modifier and Type	Method and Description
static <T> java.util.function.Consumer<T>	rethrow(ThrowingConsumer<T> consumer) Transform a throwing consumer into a non throwing consumer by wrapping exceptions in RuntimeExceptions
static void	rethrow(ThrowingRunnable runnable) Try to run a runnable, rethrowing any exception wrapped in a RuntimeException
static <T,R> java.util.function.Function<T,R>	rethrowR(ThrowingFunction<T,R> func) Transform a throwing function into a non throwing function by wrapping exceptions in RuntimeExceptions
static <T> T	rethrowR(ThrowingSupplier<T> supplier) Try to get a value from the given supplier, rethrowing any exception wrapped in a RuntimeException

Methods inherited from class java.lang.Object

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

Constructor Detail

Exceptions

public Exceptions()

Method Detail

rethrowR

public static <T> T rethrowR(@NonNull
                             ThrowingSupplier<T> supplier)

Try to get a value from the given supplier, rethrowing any exception wrapped in a RuntimeException

Type Parameters:

T - the type of element to get

Parameters:

supplier - the supplier to get a value from

Returns:

the supplied value

rethrow

public static void rethrow(@NonNull
                           ThrowingRunnable runnable)

Try to run a runnable, rethrowing any exception wrapped in a RuntimeException

Parameters:

runnable - the runnable to run

rethrowR

public static <T,R> java.util.function.Function<T,R> rethrowR(@NonNull
                                                              ThrowingFunction<T,R> func)

Transform a throwing function into a non throwing function by wrapping exceptions in RuntimeExceptions

Type Parameters:

T - the functions input type

R - the functions return type

Parameters:

func - the function to transform

Returns:

the transformed non-throwing function

rethrow

public static <T> java.util.function.Consumer<T> rethrow(@NonNull
                                                         ThrowingConsumer<T> consumer)

Transform a throwing consumer into a non throwing consumer by wrapping exceptions in RuntimeExceptions

Type Parameters:

T - the consumers input type

Parameters:

consumer - the consumer to transform

Returns:

the transformed non-throwing consumer