io.permazen.util

Class ThrowableUtil

java.lang.Object

io.permazen.util.ThrowableUtil

public final class ThrowableUtil
extends Object

Utility methods dealing with Throwables.

Method Summary

Modifier and Type	Method and Description
static StackTraceElement[]	appendStackFrames(Throwable t, StackTraceElement[] outerFrames) Prepend stack frames from the current thread onto the given exception's stack frames and return the result.
static <T extends Throwable> T	maskException(Throwable t) Mask a checked exception and throw it as an unchecked exception.
static void	prependCurrentStackTrace(Throwable t) Prepend stack frames from the current thread onto the given exception's stack frames.

Methods inherited from class java.lang.Object

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

Method Detail

maskException

public static <T extends Throwable> T maskException(Throwable t)
                                             throws T extends Throwable

Mask a checked exception and throw it as an unchecked exception.

Type Parameters:

T - unchecked exception type

Parameters:

t - any exception

Returns:

never

Throws:

T - always

T extends Throwable

prependCurrentStackTrace

public static void prependCurrentStackTrace(Throwable t)

Prepend stack frames from the current thread onto the given exception's stack frames.

This is used to re-throw an exception created in another thread without losing the stack frame information associated with the current thread.

Parameters:

t - exception from another thread

Throws:

IllegalArgumentException - if t is null

appendStackFrames

public static StackTraceElement[] appendStackFrames(Throwable t,
                                                    StackTraceElement[] outerFrames)

Prepend stack frames from the current thread onto the given exception's stack frames and return the result.

Parameters:

t - original exception

outerFrames - stack frames that should wrap t's stack frames

Returns:

an array containing t's stack frames, followed by outerFrames

Throws:

IllegalArgumentException - if t or outerFrames is null