de.team33.libs.exceptional.v4

Class Handling<T extends Throwable>

java.lang.Object

de.team33.libs.exceptional.v4.Handling<T>

public class Handling<T extends Throwable>
extends Object

A tool that supports the differentiated handling of exceptions.

Method Summary

Modifier and Type	Method and Description
T	fallback() Returns the associated subject.
static <T extends Throwable> Handling<T>	of(T subject) Initiates a Handling of the given subject.
<X extends Throwable> Handling<T>	reThrowCauseIf(Class<X> type) Re-throws the cause of the associated subject if it matches the given exception type.
<X extends Throwable> Handling<T>	reThrowIf(Class<X> type) Re-throws the associated subject if it matches the given exception type.
<X extends Throwable> Handling<T>	throwMapped(Function<? super T,X> mapping) Applies the given mapping to the associated subject and throws the result if is it NOT null.
<X extends Throwable> Handling<T>	throwMappedCause(Function<Throwable,X> mapping) Applies the given mapping to the cause of the associated subject and throws the result if is it NOT null.

Methods inherited from class java.lang.Object

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

Method Detail

of

public static <T extends Throwable> Handling<T> of(T subject)

Initiates a Handling of the given subject.

throwMapped

public final <X extends Throwable> Handling<T> throwMapped(Function<? super T,X> mapping)
                                                    throws X extends Throwable

Applies the given mapping to the associated subject and throws the result if is it NOT null. Otherwise this Handling will be returned.

This method is used to re-specify an exception. For example, if an exception was caught as a very common type, e.g. an Exception. At the same time, a suitable mapping to the respective exception can be applied with this variant.

Throws:

X extends Throwable

See Also:

reThrowIf(Class)

reThrowIf

public final <X extends Throwable> Handling<T> reThrowIf(Class<X> type)
                                                  throws X extends Throwable

Re-throws the associated subject if it matches the given exception type. Otherwise this Handling will be returned.

This method is used to re-specify an exception. For example, if an exception was caught as a very common type, e.g. an Exception.

Throws:

X extends Throwable

See Also:

throwMapped(Function)

throwMappedCause

public final <X extends Throwable> Handling<T> throwMappedCause(Function<Throwable,X> mapping)
                                                         throws X extends Throwable

Applies the given mapping to the cause of the associated subject and throws the result if is it NOT null. Otherwise this Handling will be returned.

This method is used to bring the cause of an exception back to the foreground. For example, if an exception was previously caught and encapsulated in another exception for technical reasons, e.g. a RuntimeException. At the same time, a suitable mapping to the respective exception can be applied with this variant.

Throws:

X extends Throwable

See Also:

reThrowCauseIf(Class)

reThrowCauseIf

public final <X extends Throwable> Handling<T> reThrowCauseIf(Class<X> type)
                                                       throws X extends Throwable

Re-throws the cause of the associated subject if it matches the given exception type. Otherwise this Handling will be returned.

This method is used to bring the cause of an exception back to the foreground. For example, if an exception was previously caught and encapsulated in another exception for technical reasons, e.g. a RuntimeException.

Throws:

X extends Throwable

See Also:

throwMappedCause(Function)

fallback

public final T fallback()

Returns the associated subject.