Class Throwables

java.lang.Object

org.junit.internal.Throwables

public final class Throwables
extends Object

Miscellaneous functions dealing with Throwable.

Since:

4.12

Author:

kcooney@google.com (Kevin Cooney)

Method Summary

Modifier and Type	Method	Description
static String	getStacktrace(Throwable exception)	Returns the stacktrace of the given Throwable as a String.
static String	getTrimmedStackTrace(Throwable exception)	Gets a trimmed version of the stack trace of the given exception.
static Exception	rethrowAsException(Throwable e)	Rethrows the given Throwable, allowing the caller to declare that it throws Exception.

Methods inherited from class Object

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

Method Details

rethrowAsException

public static Exception rethrowAsException(Throwable e)
                                    throws Exception

Rethrows the given Throwable, allowing the caller to declare that it throws Exception. This is useful when your callers have nothing reasonable they can do when a Throwable is thrown. This is declared to return Exception so it can be used in a throw clause:

try {
  doSomething();
} catch (Throwable e} {
  throw Throwables.rethrowAsException(e);
}
doSomethingLater();

Parameters:

e - exception to rethrow

Returns:

does not return anything

Throws:

Exception

Since:

4.12

getStacktrace

public static String getStacktrace(Throwable exception)

Returns the stacktrace of the given Throwable as a String.

Since:

4.13

getTrimmedStackTrace

public static String getTrimmedStackTrace(Throwable exception)

Gets a trimmed version of the stack trace of the given exception. Stack trace elements that are below the test method are filtered out.

Returns:

a trimmed stack trace, or the original trace if trimming wasn't possible