votorola.g.lang

Class ThrowableX

java.lang.Object

ThrowableX

@ThreadSafe
public final class ThrowableX
extends Object

Throwable utilities.

Field Summary

Fields

Modifier and Type	Field and Description
static List<Throwable>	ENLIST_NONE An empty and immutable list of throwables for use with listedThrowable.

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	isSimilar(Throwable t1, Throwable t2) Returns true if both throwables are similar, or both null.
static List<Throwable>	listedThrowable(Throwable x, List<Throwable> list) Enlists the specified throwable and returns the list.
static String	toStringExpanded(Throwable t) Contructs an expanded toString that includes the throwable's own, plus that of all nested causes.

Methods inherited from class java.lang.Object

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

Field Detail

ENLIST_NONE

public static final List<Throwable> ENLIST_NONE

An empty and immutable list of throwables for use with listedThrowable.

Method Detail

isSimilar

public static boolean isSimilar(Throwable t1,
                Throwable t2)

Returns true if both throwables are similar, or both null. Compares class, message, nested causes and stack trace. These comparisons are sufficient to discriminate among basic throwables, but not necessarily among their subclasses.

listedThrowable

public static List<Throwable> listedThrowable(Throwable x,
                              List<Throwable> list)

Enlists the specified throwable and returns the list.

Parameters:

list - the pre-constructed list to use. ENLIST_NONE may be specified in order to defeat enlistment and instead force immediate throwing, but the caller is responsible for detecting and implementing that. Passing ENLIST_NONE into this method will raise UnsupportedOperationException.

Returns:

the pre-constructed list, or if necessary a lazily constructed linked list.

toStringExpanded

public static String toStringExpanded(Throwable t)

Contructs an expanded toString that includes the throwable's own, plus that of all nested causes.