org.mule.runtime.api.exception

Class ExceptionHelper

java.lang.Object

org.mule.runtime.api.exception.ExceptionHelper

public class ExceptionHelper
extends Object

ExceptionHelper provides a number of helper functions that can be useful for dealing with Mule exceptions. This class has 3 core functions -

1. ErrorCode lookup. A corresponding Mule error code can be found using for a given Mule exception 2. Additional Error information such as Java doc url for a given exception can be resolved using this class 3. Error code mappings can be looked up by providing the the protocol to map to and the Mule exception.

Since:

1.0

Field Summary

Fields

Modifier and Type	Field and Description
static String[]	DEFAULT_STACKTRACE_FILTER
static boolean	fullStackTraces When false (default), some internal Mule entries are removed from exception stacktraces for readability.
static String[]	stackTraceFilter A comma-separated list of internal packages/classes which are removed from sanitized stacktraces.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ExceptionHelper() Do not instanciate.

Method Summary

Modifier and Type	Method and Description
static Map	getExceptionInfo(Throwable t)
static ExceptionReader	getExceptionReader(Throwable t) Gets an exception reader for the exception
static List<Throwable>	getExceptionsAsList(Throwable t)
static String	getExceptionStack(Throwable t)
static Throwable	getNonMuleException(Throwable t)
static Throwable	getRootException(Throwable t)
static MuleException	getRootMuleException(Throwable t)
static void	registerExceptionReader(ExceptionReader reader) Registers an exception reader with Mule
static Throwable	sanitize(Throwable t) Removes some internal Mule entries from the stacktrace.
static Throwable	summarise(Throwable t, int depth) Removes some internal Mule entries from the stacktrace.
static <T extends Throwable> T	unwrap(T t)

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_STACKTRACE_FILTER

public static final String[] DEFAULT_STACKTRACE_FILTER

stackTraceFilter

public static String[] stackTraceFilter

A comma-separated list of internal packages/classes which are removed from sanitized stacktraces. Matching is done via string.startsWith().

See Also:

fullStackTraces

fullStackTraces

public static boolean fullStackTraces

When false (default), some internal Mule entries are removed from exception stacktraces for readability.

See Also:

stackTraceFilter

Constructor Detail

ExceptionHelper

protected ExceptionHelper()

Do not instanciate.

Method Detail

unwrap

public static <T extends Throwable> T unwrap(T t)

getExceptionReader

public static ExceptionReader getExceptionReader(Throwable t)

Gets an exception reader for the exception

Parameters:

t - the exception to get a reader for

Returns:

either a specific reader or an instance of DefaultExceptionReader. This method never returns null;

getRootMuleException

public static MuleException getRootMuleException(Throwable t)

getNonMuleException

public static Throwable getNonMuleException(Throwable t)

getExceptionInfo

public static Map getExceptionInfo(Throwable t)

getRootException

public static Throwable getRootException(Throwable t)

getExceptionStack

public static String getExceptionStack(Throwable t)

sanitize

public static Throwable sanitize(Throwable t)

Removes some internal Mule entries from the stacktrace. Modifies the passed-in throwable stacktrace.

summarise

public static Throwable summarise(Throwable t,
                                  int depth)

Removes some internal Mule entries from the stacktrace. Modifies the passed-in throwable stacktrace.

getExceptionsAsList

public static List<Throwable> getExceptionsAsList(Throwable t)

registerExceptionReader

public static void registerExceptionReader(ExceptionReader reader)

Registers an exception reader with Mule

Parameters:

reader - the reader to register.