org.nuxeo.common.utils

Class ExceptionUtils

java.lang.Object

org.nuxeo.common.utils.ExceptionUtils

public final class ExceptionUtils
extends Object

Provides utility methods for manipulating and examining exceptions in a generic way.

Author:

DM

Method Summary

Modifier and Type	Method and Description
static void	checkInterrupt(Exception e) Throws a RuntimeException if the passed exception is an InterruptedException or InterruptedIOException, or if the current thread is marked interrupted.
static Throwable	getRootCause(Throwable throwable) Gets the root cause of the given Throwable.
static RuntimeException	runtimeException(Exception e) Wraps the exception into a RuntimeException, if needed, for re-throw.
static Exception	unwrapInvoke(Exception e) Unwraps the exception if it's an InvocationTargetException.

Methods inherited from class java.lang.Object

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

Method Detail

getRootCause

public static Throwable getRootCause(Throwable throwable)

Gets the root cause of the given Throwable.

This method walks through the exception chain up to the root of the exceptions tree using Throwable.getCause(), and returns the root exception.

Parameters:

throwable - the throwable to get the root cause for, may be null - this is to avoid throwing other un-interesting exception when handling a business-important exception

Returns:

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

checkInterrupt

public static void checkInterrupt(Exception e)

Throws a RuntimeException if the passed exception is an InterruptedException or InterruptedIOException, or if the current thread is marked interrupted.

Parameters:

e - the exception to check

Throws:

RuntimeException - if there was an interrupt

Since:

7.1

unwrapInvoke

public static Exception unwrapInvoke(Exception e)

Unwraps the exception if it's an InvocationTargetException.

Also deals with interrupts by immediately throwing an exception.

Parameters:

e - the exception to unwrap

Returns:

the unwrapped exception

Throws:

RuntimeException - if there was an interrupt

Since:

7.1

runtimeException

public static RuntimeException runtimeException(Exception e)

Wraps the exception into a RuntimeException, if needed, for re-throw.

Deals with InvocationTargetException, InterruptedException and InterruptedIOException.

Parameters:

e - the exception to wrap

Returns:

a RuntimeException

Throws:

RuntimeException - if there was an interrupt

Since:

7.1