org.kocakosm.pitaya.util

Class Throwables

java.lang.Object

org.kocakosm.pitaya.util.Throwables

public final class Throwables
extends Object

Utilities for Throwables.

Author:

Osman KOCAK

Method Summary

Modifier and Type	Method and Description
static List<Throwable>	getCauseChain(Throwable t) Returns the chain of Throwables that caused the given one.
static Throwable	getRootCause(Throwable t) Returns the root cause of the given Throwable.
static List<String>	getStackFrames(Throwable t) Returns the stack frames of the given Throwable.
static String	getStackTrace(Throwable t) Returns the stack trace of the given Throwable as a String.
static RuntimeException	propagate(Throwable t) Re-throws the given Throwable if it is already an instance of RuntimeException or Error, and, if not, wraps it in a RuntimeException before throwing it.

Methods inherited from class java.lang.Object

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

Method Detail

getRootCause

public static Throwable getRootCause(Throwable t)

Returns the root cause of the given Throwable. If the given Throwable is not the result of a previous one, it is considered as the root.

Parameters:

t - the Throwable to get the root cause.

Returns:

the root cause of the given Throwable.

Throws:

NullPointerException - if t is null.

getCauseChain

public static List<Throwable> getCauseChain(Throwable t)

Returns the chain of Throwables that caused the given one. The given Throwable is the first element in the returned List, the last one is the root cause.

Parameters:

t - the Throwable to get the chain.

Returns:

the chain of Throwable that caused t.

Throws:

NullPointerException - if t is null.

getStackTrace

public static String getStackTrace(Throwable t)

Returns the stack trace of the given Throwable as a String.

Parameters:

t - the Throwable to get the stack trace.

Returns:

the stack trace of the given Throwable.

Throws:

NullPointerException - if t is null.

getStackFrames

public static List<String> getStackFrames(Throwable t)

Returns the stack frames of the given Throwable. The stack frames are simply obtained from calling toString on each StackTraceElement of t.

Parameters:

t - the Throwable to get the stack frames.

Returns:

the stack frames of the given Throwable.

Throws:

NullPointerException - if t is null.

See Also:

Throwable.getStackTrace()

propagate

public static RuntimeException propagate(Throwable t)

Re-throws the given Throwable if it is already an instance of RuntimeException or Error, and, if not, wraps it in a RuntimeException before throwing it.

Parameters:

t - the Throwable to propagate.

Returns:

nothing (this method always throws a Throwable).

Throws:

NullPointerException - if t is null.

RuntimeException - if t is already an instance of RuntimeException or if t is neither an instance of RuntimeException nor an instance of Error.

Error - if t is an instance of Error.