org.tentackle.common

Class ExceptionHelper

java.lang.Object

org.tentackle.common.ExceptionHelper

public final class ExceptionHelper
extends Object

Helper methods dealing with exceptions.

Author:

harald

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ExceptionHelper.Handler<T extends Throwable> Exception handler.

Method Summary

Modifier and Type	Method and Description
static String	concatenateMessages(Throwable headOfChain) Concatenates the messages of an exception chain.
static Throwable	extractException(boolean first, Throwable headOfChain, Class<? extends Throwable>... types) Extracts any of the given exception types from an exception chain.
static <T extends Throwable> T	extractException(Class<T> type, boolean first, Throwable headOfChain) Extracts the given exception type from an exception chain.
static String	getStackTraceAsString(Throwable cause) Returns the stacktrace of a given exception as a string.
static boolean	handleException(boolean first, Throwable headOfChain, ExceptionHelper.Handler<? extends Throwable>... handlers) Extracts any of the given exception types from an exception chain.

Methods inherited from class java.lang.Object

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

Method Detail

extractException

public static <T extends Throwable> T extractException(Class<T> type,
                                                       boolean first,
                                                       Throwable headOfChain)

Extracts the given exception type from an exception chain.

Type Parameters:

T - the exception type to search for

Parameters:

type - the exception class to search for

first - true if finds the first, else the last in chain

headOfChain - the head of chained exceptions, may be null

Returns:

the exception, null if none

extractException

public static Throwable extractException(boolean first,
                                         Throwable headOfChain,
                                         Class<? extends Throwable>... types)

Extracts any of the given exception types from an exception chain.

Parameters:

first - true if finds the first, else the last in chain

headOfChain - the head of chained exceptions, may be null

types - the exception classes to search for

Returns:

the exception, null if none

handleException

public static boolean handleException(boolean first,
                                      Throwable headOfChain,
                                      ExceptionHelper.Handler<? extends Throwable>... handlers)

Extracts any of the given exception types from an exception chain.

Parameters:

first - true if handle the first, else the last in chain

headOfChain - the head of chained exceptions, may be null

handlers - the exception handlers

Returns:

true if handled, false if no matching exception found in chain

concatenateMessages

public static String concatenateMessages(Throwable headOfChain)

Concatenates the messages of an exception chain.

Parameters:

headOfChain - the head of chained exceptions, may be null

Returns:

the message string

getStackTraceAsString

public static String getStackTraceAsString(Throwable cause)

Returns the stacktrace of a given exception as a string.

Parameters:

cause - the exception

Returns:

the stacktrace as a printable string