com.blazebit.exception

Class ExceptionUtils

java.lang.Object

com.blazebit.exception.ExceptionUtils

public final class ExceptionUtils
extends Object

Utility class for exception objects.

Since:

0.1.2

Author:

Christian Beikov, Thomas Herzog

Method Summary

Modifier and Type	Method and Description
static void	doThrow(Throwable e) Throws the given throwable even if it is a checked exception.
static Throwable	getCause(Throwable e, Class<? extends Throwable>... causes) Gets the cause which are one of the given expected causes.
static Throwable	unwrap(Throwable t, Class<? extends Throwable>... throwableClasses) Unwraps the throwable until it is no instance of the throwableClass.
static Throwable	unwrap(Throwable t, Class<? extends Throwable> throwableClass)

Methods inherited from class java.lang.Object

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

Method Detail

doThrow

public static void doThrow(Throwable e)

Throws the given throwable even if it is a checked exception.

Parameters:

e - The throwable to throw.

unwrap

@SafeVarargs
public static Throwable unwrap(Throwable t,
                                             Class<? extends Throwable>... throwableClasses)

Unwraps the throwable until it is no instance of the throwableClass. Basically this method unwraps the throwable instances by calling getCause() except the throwable element is an instance of InvocationTargetException. When an InvocationTargetException is given getTargetException() is used for unwrapping.

Be carefull when you use this method with a too general throwableClass. It might be, that getCause() returns the this element in some cases and this could lead to an endless loop!

Parameters:

t - The throwable to unwrap

throwableClass - The class of which a throwable must be to be unwrapped

Returns:

The unwrapped throwable or null if no further causes can be unwrapped

unwrap

public static Throwable unwrap(Throwable t,
                               Class<? extends Throwable> throwableClass)

getCause

public static Throwable getCause(Throwable e,
                                 Class<? extends Throwable>... causes)

Gets the cause which are one of the given expected causes. This method is useful when you have to find a cause within unexpected or unpredictable exception wrappings.

Parameters:

e - the exception instance to search the cause on

causes - the causes which are searched.

Returns:

the found cause, where the first occurring cause instance will be returned. If the cause could not be found, then null will be returned