de.jakop.lotus.domingo.exception

Class ExceptionUtil

java.lang.Object

de.jakop.lotus.domingo.exception.ExceptionUtil

public final class ExceptionUtil
extends Object

Utilities for manipulating and examining Throwables.

Field Summary

Fields

Modifier and Type	Field and Description
static char	INNER_CLASS_SEPARATOR_CHAR Inner class separator character: '$' == 36.
static String	PACKAGE_SEPARATOR The package separator String: ".".
static char	PACKAGE_SEPARATOR_CHAR Package separator character: '.' == 46.

Method Summary

Modifier and Type	Method and Description
static Throwable	getCause(Throwable throwable) Introspects the Throwable to obtain the cause.
static String	getShortClassName(Class clazz) Gets the class name minus the package name from a Class.
static String	getShortClassName(Object object, String valueIfNull) Gets the class name minus the package name for an Object.
static String	getShortClassName(String className) Gets the class name minus the package name from a String.
protected static String[]	getStackFrames(Throwable throwable) Captures the stack trace associated with the specified Throwable object, decomposing it into a list of stack frames.
static String	getStackTrace(Throwable throwable) Gets the stack trace from a Throwable as a String.
static boolean	isCascadingThrowable() Checks if the Throwable class has a getCause method.
static boolean	isCascadingThrowable(Throwable throwable) Checks whether this Throwable class can store a cause.
static void	printStackTrace(Throwable throwable) Prints the stack trace of a throwable to the standard error stream.
static void	printStackTrace(Throwable throwable, PrintStream out) Prints the stack trace of a throwable to the specified stream.
static void	printStackTrace(Throwable throwable, PrintWriter out) Prints the stack trace of a throwable to the specified writer.
static void	removeCommonFrames(List causeFrames, List wrapperFrames) Removes common frames from the cause trace given the two stack traces.
protected static void	trimStackFrames(List stacks) Trims the stack frames.

Methods inherited from class java.lang.Object

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

Field Detail

PACKAGE_SEPARATOR_CHAR

public static final char PACKAGE_SEPARATOR_CHAR

Package separator character: '.' == 46.

See Also:

Constant Field Values

PACKAGE_SEPARATOR

public static final String PACKAGE_SEPARATOR

The package separator String: ".".

INNER_CLASS_SEPARATOR_CHAR

public static final char INNER_CLASS_SEPARATOR_CHAR

Inner class separator character: '$' == 36.

See Also:

Constant Field Values

Method Detail

getCause

public static Throwable getCause(Throwable throwable)

Introspects the Throwable to obtain the cause.

The method searches for methods with specific names that return a Throwable object. This will pick up most wrapping exceptions, including those from JDK 1.4, and the domingo exceptions.

The default list searched for are:

• getCause()
• getNextException()
• getTargetException()
• getException()
• getSourceException()
• getRootCause()
• getCausedByException()
• getNested()

In the absence of any such method, the object is inspected for a detail field assignable to a Throwable.

If none of the above is found, returns null.

Parameters:

throwable - the throwable to introspect for a cause, may be null

Returns:

the cause of the Throwable, null if none found or null throwable input

isCascadingThrowable

public static boolean isCascadingThrowable()

Checks if the Throwable class has a getCause method.

This is true for JDK 1.4 and above.

Returns:

true if Throwable is cascading

isCascadingThrowable

public static boolean isCascadingThrowable(Throwable throwable)

Checks whether this Throwable class can store a cause.

This method does not check whether it actually does store a cause.

Parameters:

throwable - the Throwable to examine, may be null

Returns:

boolean true if cascading, otherwise false

removeCommonFrames

public static void removeCommonFrames(List causeFrames,
                                      List wrapperFrames)
                               throws IllegalArgumentException

Removes common frames from the cause trace given the two stack traces.

Parameters:

causeFrames - stack trace of a cause throwable

wrapperFrames - stack trace of a wrapper throwable

Throws:

IllegalArgumentException - if either argument is null

getStackTrace

public static String getStackTrace(Throwable throwable)

Gets the stack trace from a Throwable as a String.

The result of this method vary by JDK version as this method uses Throwable.printStackTrace(java.io.PrintWriter). On JDK1.3 and earlier, the cause exception will not be shown unless the specified throwable alters printStackTrace.

Parameters:

throwable - the Throwable to be examined

Returns:

the stack trace as generated by the exception's printStackTrace(PrintWriter) method

getShortClassName

public static String getShortClassName(Object object,
                                       String valueIfNull)

Gets the class name minus the package name for an Object.

Parameters:

object - the class to get the short name for, may be null

valueIfNull - the value to return if null

Returns:

the class name of the object without the package name, or the null value

getShortClassName

public static String getShortClassName(Class clazz)

Gets the class name minus the package name from a Class.

Parameters:

clazz - the class to get the short name for.

Returns:

the class name without the package name or an empty string

getShortClassName

public static String getShortClassName(String className)

Gets the class name minus the package name from a String.

The string passed in is assumed to be a class name - it is not checked.

Parameters:

className - the className to get the short name for

Returns:

the class name of the class without the package name or an empty string

printStackTrace

public static void printStackTrace(Throwable throwable)

Prints the stack trace of a throwable to the standard error stream.

Parameters:

throwable - a cascading throwable

printStackTrace

public static void printStackTrace(Throwable throwable,
                                   PrintStream out)

Prints the stack trace of a throwable to the specified stream.

Parameters:

throwable - a cascading throwable

out - PrintStream to use for output.

See Also:

printStackTrace(Throwable, PrintWriter)

printStackTrace

public static void printStackTrace(Throwable throwable,
                                   PrintWriter out)

Prints the stack trace of a throwable to the specified writer.

Parameters:

throwable - a cascading throwable

out - PrintWriter to use for output.

getStackFrames

protected static String[] getStackFrames(Throwable throwable)

Captures the stack trace associated with the specified Throwable object, decomposing it into a list of stack frames.

Parameters:

throwable - The Throwable.

Returns:

An array of strings describing each stack frame.

trimStackFrames

protected static void trimStackFrames(List stacks)

Trims the stack frames. The first set is left untouched. The rest of the frames are truncated from the bottom by comparing with one just on top.

Parameters:

stacks - The list containing String[] elements