jodd.exception

Class ExceptionUtil

java.lang.Object

jodd.exception.ExceptionUtil

public class ExceptionUtil
extends java.lang.Object

Few exception utilities.

Constructor Summary

Constructors

Constructor and Description
ExceptionUtil()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	buildMessage(java.lang.String message, java.lang.Throwable cause) Build a message for the given base message and its cause.
static java.lang.String	exceptionChainToString(java.lang.Throwable t) Prints full exception stack trace, from top to root cause, into a String.
static java.lang.String	exceptionStackTraceToString(java.lang.Throwable t) Prints stack trace into a String.
static <T extends java.lang.Throwable> T	findCause(java.lang.Throwable throwable, java.lang.Class<T> cause) Finds throwing cause in exception stack.
static java.lang.StackTraceElement[]	getCurrentStackTrace() Returns current stack trace in form of array of stack trace elements.
static java.lang.Throwable[]	getExceptionChain(java.lang.Throwable throwable) Returns exception chain starting from top up to root cause.
static java.lang.Throwable	getRootCause(java.lang.Throwable throwable) Introspects the Throwable to obtain the root cause.
static java.lang.StackTraceElement[]	getStackTrace(java.lang.Throwable t, java.lang.String[] allow, java.lang.String[] deny) Returns stack trace filtered by class names.
static java.lang.StackTraceElement[][]	getStackTraceChain(java.lang.Throwable t, java.lang.String[] allow, java.lang.String[] deny) Returns stack trace chain filtered by class names.
static java.lang.String	message(java.lang.Throwable throwable) Returns non-null message for a throwable.
static java.sql.SQLException	rollupSqlExceptions(java.util.Collection<java.sql.SQLException> exceptions) Rolls up SQL exceptions by taking each proceeding exception and making it a child of the previous using the setNextException method of SQLException.
static void	throwRuntimeException(java.lang.Throwable throwable) Throws checked exceptions in un-checked manner.
static java.lang.Throwable	unwrapThrowable(java.lang.Throwable wrappedThrowable) Unwraps invocation and undeclared exceptions to real cause.
static java.lang.Exception	wrapToException(java.lang.Throwable throwable)
static java.lang.RuntimeException	wrapToRuntimeException(java.lang.Throwable throwable) Wraps exception to RuntimeException.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExceptionUtil

public ExceptionUtil()

Method Detail

getCurrentStackTrace

public static java.lang.StackTraceElement[] getCurrentStackTrace()

Returns current stack trace in form of array of stack trace elements. First stack trace element is removed. Since an exception is thrown internally, this method is slow.

getStackTrace

public static java.lang.StackTraceElement[] getStackTrace(java.lang.Throwable t,
                                                          java.lang.String[] allow,
                                                          java.lang.String[] deny)

Returns stack trace filtered by class names.

getStackTraceChain

public static java.lang.StackTraceElement[][] getStackTraceChain(java.lang.Throwable t,
                                                                 java.lang.String[] allow,
                                                                 java.lang.String[] deny)

Returns stack trace chain filtered by class names.

getExceptionChain

public static java.lang.Throwable[] getExceptionChain(java.lang.Throwable throwable)

Returns exception chain starting from top up to root cause.

exceptionStackTraceToString

public static java.lang.String exceptionStackTraceToString(java.lang.Throwable t)

Prints stack trace into a String.

exceptionChainToString

public static java.lang.String exceptionChainToString(java.lang.Throwable t)

Prints full exception stack trace, from top to root cause, into a String.

buildMessage

public static java.lang.String buildMessage(java.lang.String message,
                                            java.lang.Throwable cause)

Build a message for the given base message and its cause.

getRootCause

public static java.lang.Throwable getRootCause(java.lang.Throwable throwable)

Introspects the Throwable to obtain the root cause.

This method walks through the exception chain to the last element, "root" of the tree, and returns that exception. If no root cause found returns provided throwable.

findCause

public static <T extends java.lang.Throwable> T findCause(java.lang.Throwable throwable,
                                                          java.lang.Class<T> cause)

Finds throwing cause in exception stack. Returns throwable object if cause class is matched. Otherwise, returns null.

rollupSqlExceptions

public static java.sql.SQLException rollupSqlExceptions(java.util.Collection<java.sql.SQLException> exceptions)

Rolls up SQL exceptions by taking each proceeding exception and making it a child of the previous using the setNextException method of SQLException.

throwRuntimeException

public static void throwRuntimeException(java.lang.Throwable throwable)

Throws checked exceptions in un-checked manner.

message

public static java.lang.String message(java.lang.Throwable throwable)

Returns non-null message for a throwable.

wrapToRuntimeException

public static java.lang.RuntimeException wrapToRuntimeException(java.lang.Throwable throwable)

Wraps exception to RuntimeException.

wrapToException

public static java.lang.Exception wrapToException(java.lang.Throwable throwable)

unwrapThrowable

public static java.lang.Throwable unwrapThrowable(java.lang.Throwable wrappedThrowable)

Unwraps invocation and undeclared exceptions to real cause.