Package no.digipost

Class DiggExceptions

java.lang.Object

no.digipost.DiggExceptions

public final class DiggExceptions
extends Object

Field Summary

Fields

Modifier and Type	Field	Description
static Consumer<Exception>	rethrowAnyException	This consumer rethrows any given Exception as an unchecked RuntimeException.

Method Summary

Modifier and Type	Method	Description
static <T,R> R	applyUnchecked(ThrowingFunction<T,R,? extends Throwable> function, T argument)	Immediately apply the given function with the given argument, and if needed, convert any thrown exceptions to unckecked.
static RuntimeException	asUnchecked(Throwable t)	Utility for acquiring a RuntimeException from any Throwable.
static RuntimeException	asUnchecked(Throwable t, String message)	Utility for acquiring a RuntimeException with a custom message from any Throwable.
static <X extends Throwable> RuntimeException	asUnchecked(X t, Function<? super X,String> messageCreator)	Utility for acquiring a RuntimeException with a custom message from any Throwable.
static Stream<Throwable>	causalChainOf(Throwable t)
static String	exceptionNameAndMessage(Throwable t)	Generate a concise description of an exception/throwable containing the "friendly name" of the exception's type, and its message.
static <T> T	getUnchecked(ThrowingSupplier<T,? extends Throwable> supplier)	Immediately get a result from the given supplier, and if needed, convert any thrown exceptions to unckecked.
static <T,U,X extends Throwable> ThrowingBiConsumer<T,U,X>	mayThrow(ThrowingBiConsumer<T,U,X> consumer)	Convenience to acquire a ThrowingBiConsumer-reference from a lambda expression.
static <T,U,R,X extends Throwable> ThrowingBiFunction<T,U,R,X>	mayThrow(ThrowingBiFunction<T,U,R,X> bifunction)	Convenience to acquire a ThrowingBiFunction-reference from a lambda expression.
static <T,X extends Throwable> ThrowingConsumer<T,X>	mayThrow(ThrowingConsumer<T,X> consumer)	Convenience to acquire a ThrowingConsumer-reference from a lambda expression.
static <T,R,X extends Throwable> ThrowingFunction<T,R,X>	mayThrow(ThrowingFunction<T,R,X> function)	Convenience to acquire a ThrowingFunction-reference from a lambda expression.
static <T,X extends Throwable> ThrowingRunnable<X>	mayThrow(ThrowingRunnable<X> runnable)	Convenience to acquire a ThrowingRunnable-reference from a lambda expression.
static <T,X extends Throwable> ThrowingSupplier<T,X>	mayThrow(ThrowingSupplier<T,X> supplier)	Convenience to acquire a ThrowingSupplier-reference from a lambda expression.
static <T extends Throwable> Consumer<T>	rethrow(Function<T,? extends RuntimeException> createUnchecked)	Create a exception handler (Consumer) which simply rethrows given exceptions.
static void	runUnchecked(ThrowingRunnable<? extends Throwable> runnable)	Immediately run the given runnable, and if needed, convert any thrown exceptions to unckecked.

Methods inherited from class java.lang.Object

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

Field Detail

rethrowAnyException

public static final Consumer<Exception> rethrowAnyException

This consumer rethrows any given Exception as an unchecked RuntimeException.

Method Detail

causalChainOf

public static Stream<Throwable> causalChainOf(Throwable t)

Parameters:

t - the Throwable to get the causal chain from.

Returns:

the entire chain of causes, including the given Throwable.

exceptionNameAndMessage

public static String exceptionNameAndMessage(Throwable t)

Generate a concise description of an exception/throwable containing the "friendly name" of the exception's type, and its message.

Parameters:

t - the exception/throwable

Returns:

the description

asUnchecked

public static RuntimeException asUnchecked(Throwable t)

Utility for acquiring a RuntimeException from any Throwable. This method is appropriate to use when you have caught an exception which you have no ability to handle, and you need to just throw it from a context where you are not allowed to.

If you want to add more context to the thrown exception (which you probably should), consider using asUnchecked(Throwable, String) or asUnchecked(Throwable, Function).

Parameters:

t - the exception (Throwable)

Returns:

a new RuntimeException which has the given exception as its cause, or t itself casted to RuntimeException if possible

asUnchecked

public static <X extends Throwable> RuntimeException asUnchecked(X t,
                                                                 Function<? super X,String> messageCreator)

Utility for acquiring a RuntimeException with a custom message from any Throwable. The result from this method will always be a new exception instance.

Type Parameters:

X - the type of the given exception

Parameters:

t - the exception (Throwable)

messageCreator - a function which returns the message for the new exception

Returns:

a new RuntimeException which has the result from the messageCreator function as its message, and the given exception as its cause

asUnchecked

public static RuntimeException asUnchecked(Throwable t,
                                           String message)

Utility for acquiring a RuntimeException with a custom message from any Throwable. The result from this method will always be a new exception instance.

Parameters:

t - the exception (Throwable)

message - the message for the new exception

Returns:

a new RuntimeException which has the given message, and the given exception as its cause

applyUnchecked

public static <T,R> R applyUnchecked(ThrowingFunction<T,R,? extends Throwable> function,
                                           T argument)

Immediately apply the given function with the given argument, and if needed, convert any thrown exceptions to unckecked.

Parameters:

function - The ThrowingFunction.

argument - The argument to pass to ThrowingFunction.apply(Object)

Returns:

the result.

getUnchecked

public static <T> T getUnchecked(ThrowingSupplier<T,? extends Throwable> supplier)

Immediately get a result from the given supplier, and if needed, convert any thrown exceptions to unckecked.

Parameters:

supplier - The ThrowingSupplier.

Returns:

the result.

runUnchecked

public static void runUnchecked(ThrowingRunnable<? extends Throwable> runnable)

Immediately run the given runnable, and if needed, convert any thrown exceptions to unckecked.

Parameters:

runnable - The ThrowingRunnable.

mayThrow

public static final <T,R,X extends Throwable> ThrowingFunction<T,R,X> mayThrow(ThrowingFunction<T,R,X> function)

Convenience to acquire a ThrowingFunction-reference from a lambda expression.

mayThrow

public static final <T,U,R,X extends Throwable> ThrowingBiFunction<T,U,R,X> mayThrow(ThrowingBiFunction<T,U,R,X> bifunction)

Convenience to acquire a ThrowingBiFunction-reference from a lambda expression.

mayThrow

public static final <T,X extends Throwable> ThrowingSupplier<T,X> mayThrow(ThrowingSupplier<T,X> supplier)

Convenience to acquire a ThrowingSupplier-reference from a lambda expression.

mayThrow

public static final <T,X extends Throwable> ThrowingConsumer<T,X> mayThrow(ThrowingConsumer<T,X> consumer)

Convenience to acquire a ThrowingConsumer-reference from a lambda expression.

mayThrow

public static final <T,U,X extends Throwable> ThrowingBiConsumer<T,U,X> mayThrow(ThrowingBiConsumer<T,U,X> consumer)

Convenience to acquire a ThrowingBiConsumer-reference from a lambda expression.

mayThrow

public static final <T,X extends Throwable> ThrowingRunnable<X> mayThrow(ThrowingRunnable<X> runnable)

Convenience to acquire a ThrowingRunnable-reference from a lambda expression.

rethrow

public static final <T extends Throwable> Consumer<T> rethrow(Function<T,? extends RuntimeException> createUnchecked)

Create a exception handler (Consumer) which simply rethrows given exceptions.

Parameters:

createUnchecked - a function to convert a (typically) checked exception to RuntimeException.

Returns:

the Consumer which rethrows any given exception.