flex.messaging.util

Class ExceptionUtil

java.lang.Object

flex.messaging.util.ExceptionUtil

public class ExceptionUtil
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static String[]	unwrapMethods List of no-arg methods that are known to return a wrapped throwable.

Constructor Summary

Constructors

Constructor and Description
ExceptionUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static Throwable	baseException(Throwable t) Get to the base exception (if any).
static String	exceptionFollowedByRootCausesToString(Throwable t) Utility method for converting an exception and all chained root causes into a string.
static String	exceptionToString(Throwable t) Utility method for converting an exception into a string.
static String	getCallAt(Throwable t, int nth) Return the "nth" method call from the stack trace of "t", where 0 is the top.
static String	getStackTraceLines(Throwable t, int numLines) return the top n lines of this stack trace.
static String	getStackTraceUpTo(Throwable t, String prefix) Return the stack trace up to the first line that starts with prefix.
protected static void	printExceptionStack(Throwable th, PrintWriter out, int depth) Recursively prints out a stack of wrapped exceptions.
static String	toString(Throwable t) Return the stack trace in a String.
static Throwable	wrappedException(Throwable t) Get the wrapped Exception object from the Throwable object.

Methods inherited from class java.lang.Object

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

Field Detail

unwrapMethods

public static String[] unwrapMethods

List of no-arg methods that are known to return a wrapped throwable.

Constructor Detail

ExceptionUtil

public ExceptionUtil()

Method Detail

wrappedException

public static Throwable wrappedException(Throwable t)

Get the wrapped Exception object from the Throwable object.

Parameters:

t - the Throwable object

Returns:

Throwable the wrapped exception object if any

baseException

public static Throwable baseException(Throwable t)

Get to the base exception (if any).

Parameters:

t - the Throwable object

Returns:

the base Exception object

toString

public static String toString(Throwable t)

Return the stack trace in a String.

Parameters:

t - the Throwable object

Returns:

String the String presentation of the Throwable object

getStackTraceUpTo

public static String getStackTraceUpTo(Throwable t,
                       String prefix)

Return the stack trace up to the first line that starts with prefix.

Example: ExceptionUtil.getStackTraceUpTo(exception, "jrunx.");

Parameters:

t - the Throwable object

prefix - the prefix message that we are looking for

Returns:

String the String of stack trace lines till the prefix message is located

getStackTraceLines

public static String getStackTraceLines(Throwable t,
                        int numLines)

return the top n lines of this stack trace.

Example: ExceptionUtil.getStackTraceLines(exception, 10);

Parameters:

t - the Throwable object

numLines - number of lines we should trace down

Returns:

String the String of stack trace lines

getCallAt

public static String getCallAt(Throwable t,
               int nth)

Return the "nth" method call from the stack trace of "t", where 0 is the top.

Parameters:

t - the Throwable object

nth - the line number of the message should we skip

Returns:

String the callAt String

exceptionToString

public static String exceptionToString(Throwable t)

Utility method for converting an exception into a string. This method unwinds all wrapped exceptions

Parameters:

t - The throwable exception

Returns:

The printable exception

exceptionFollowedByRootCausesToString

public static String exceptionFollowedByRootCausesToString(Throwable t)

Utility method for converting an exception and all chained root causes into a string. Unlike exceptionToString(Throwable) which prints the chain from most nested root cause down to the top-level exception, this method prints from the top-level exception down to the most nested root cause.

Parameters:

t - The throwable exception.

Returns:

The printable exception.

printExceptionStack

protected static void printExceptionStack(Throwable th,
                       PrintWriter out,
                       int depth)

Recursively prints out a stack of wrapped exceptions.