org.slieb.throwables

Class SuppressedException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.slieb.throwables.SuppressedException

All Implemented Interfaces:

Serializable

public class SuppressedException
extends RuntimeException

This exception class wraps checked exceptions as a runtime exceptions, so we can throw them in Functional interfaces such as Function and Supplier in a consistent manner.

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SuppressedException(Throwable cause)

Method Summary

Modifier and Type	Method and Description
static <E extends Throwable> void	suppress(Runnable runnable)
static <T,E extends Throwable> T	suppress(Supplier<T> supplier)
static <E extends Throwable> Optional<E>	unwrapExceptionCause(SuppressedException suppressed, Class<E> exceptionClass)
static void	unwrapSuppressedException(Runnable runnable)
static <E extends Throwable> void	unwrapSuppressedException(Runnable runnable, Class<E> exception)
static <T> T	unwrapSuppressedException(Supplier<T> supplier)
static <T,E extends Throwable> T	unwrapSuppressedException(Supplier<T> supplier, Class<E> exceptionClass)
static SuppressedException	wrapException(Throwable cause)

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

SuppressedException

protected SuppressedException(Throwable cause)

Method Detail

suppress

public static <T,E extends Throwable> T suppress(Supplier<T> supplier)

Type Parameters:

E - The exception type.

Parameters:

supplier - A supplier object which may throw some exception

suppress

public static <E extends Throwable> void suppress(Runnable runnable)

Type Parameters:

E - The exception type.

Parameters:

runnable - A supplier object which may throw some exception

wrapException

public static SuppressedException wrapException(Throwable cause)

Parameters:

cause - The original cause.

Returns:

A SuppressedException

unwrapSuppressedException

public static <T,E extends Throwable> T unwrapSuppressedException(Supplier<T> supplier,
                                                                  Class<E> exceptionClass)
                                                           throws E extends Throwable

Type Parameters:

T - The generic return type.

E - The exception type.

Parameters:

supplier - A supplier that will throw SuppressedException

exceptionClass - The class type to intercept and withUncheckedThrowable.

Returns:

The result of the supplier if no exception occurred.

Throws:

E - The original exception, that was wrapped into a SuppressedException.

E extends Throwable

unwrapSuppressedException

public static <T> T unwrapSuppressedException(Supplier<T> supplier)
                                       throws Throwable

Type Parameters:

T - The return type generic.

Parameters:

supplier - A supplier that throws SuppressedExceptions.

Returns:

The supplier's return value if not exception is thrown.

Throws:

Throwable - any throwable cause attached to the SuppressedException

unwrapSuppressedException

public static <E extends Throwable> void unwrapSuppressedException(Runnable runnable,
                                                                   Class<E> exception)
                                                            throws E extends Throwable

Type Parameters:

E - The exception class generic type.

Parameters:

runnable - A runnable that throws suppressed exceptions

exception - The exception class to intercept.

Throws:

E - The intercepted exception.

E extends Throwable

unwrapSuppressedException

public static void unwrapSuppressedException(Runnable runnable)
                                      throws Throwable

Parameters:

runnable - A runnable that throws suppressed exceptions

Throws:

Throwable - Any throwable caused that is intercepted from caught Suppressed Exceptions.

unwrapExceptionCause

public static <E extends Throwable> Optional<E> unwrapExceptionCause(SuppressedException suppressed,
                                                                     Class<E> exceptionClass)

Type Parameters:

E - The exception class type generic

Parameters:

suppressed - The caught suppressed exception

exceptionClass - The exception class type to try extract from the caught exception

Returns:

An optional of the exception, if it is a instance of the exceptionClass.