Package com.aspectran.core.util

Class ExceptionUtils

java.lang.Object

com.aspectran.core.util.ExceptionUtils

public class ExceptionUtils
extends java.lang.Object

Provides utilities for manipulating and examining Throwable objects.

Created: 2017. 10. 7.

Since:

5.0.0

Constructor Summary

Constructors

Constructor	Description
ExceptionUtils()

Method Summary

Modifier and Type	Method	Description
static java.lang.Throwable	getRootCause(java.lang.Throwable t)	Method that can be used to find the "root cause", innermost of chained (wrapped) exceptions.
static java.lang.String	getStacktrace(java.lang.Throwable throwable)	Gets the stack trace from a Throwable as a String.
static void	throwAsIAE(java.lang.Throwable t)	Method that will wrap 't' as an IllegalArgumentException if it is a checked exception; otherwise (runtime exception or error) throw as is.
static void	throwAsIAE(java.lang.Throwable t, java.lang.String msg)	Method that will wrap 't' as an IllegalArgumentException (and with specified message) if it is a checked exception; otherwise (runtime exception or error) throw as is.
static java.lang.Throwable	throwIfError(java.lang.Throwable t)	Helper method that will check if argument is an Error, and if so, (re)throw it; otherwise just return.
static java.lang.Throwable	throwIfIOE(java.lang.Throwable t)	Helper method that will check if argument is an IOException, and if so, (re)throw it; otherwise just return.
static java.lang.Throwable	throwIfRTE(java.lang.Throwable t)	Helper method that will check if argument is an RuntimeException, and if so, (re)throw it; otherwise just return.
static java.lang.Throwable	throwRootCauseIfIOE(java.lang.Throwable t)	Method that works like by calling getRootCause(java.lang.Throwable) and then either throwing it (if instanceof IOException), or return.
static void	unwrapAndThrowAsIAE(java.lang.Throwable t)	Method that will locate the innermost exception for given Throwable; and then wrap it as an IllegalArgumentException if it is a checked exception; otherwise (runtime exception or error) throw as is
static void	unwrapAndThrowAsIAE(java.lang.Throwable t, java.lang.String msg)	Method that will locate the innermost exception for given Throwable; and then wrap it as an IllegalArgumentException if it is a checked exception; otherwise (runtime exception or error) throw as is

Methods inherited from class java.lang.Object

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

Constructor Detail

ExceptionUtils

public ExceptionUtils()

Method Detail

getRootCause

public static java.lang.Throwable getRootCause(java.lang.Throwable t)

Method that can be used to find the "root cause", innermost of chained (wrapped) exceptions.

Parameters:

t - the Throwable to possibly propagate

Returns:

the root cause

getStacktrace

public static java.lang.String getStacktrace(java.lang.Throwable throwable)

Gets the stack trace from a Throwable as a String.

The result of this method vary by JDK version as this method uses Throwable.printStackTrace(java.io.PrintWriter). On JDK1.3 and earlier, the cause exception will not be shown unless the specified throwable alters printStackTrace.

Parameters:

throwable - the Throwable to be examined

Returns:

the stack trace as generated by the exception's printStackTrace(PrintWriter) method

throwIfError

public static java.lang.Throwable throwIfError(java.lang.Throwable t)

Helper method that will check if argument is an Error, and if so, (re)throw it; otherwise just return.

Parameters:

t - the Throwable to possibly propagate

Returns:

the Throwable

throwIfRTE

public static java.lang.Throwable throwIfRTE(java.lang.Throwable t)

Helper method that will check if argument is an RuntimeException, and if so, (re)throw it; otherwise just return.

Parameters:

t - the Throwable to possibly propagate

Returns:

the Throwable

throwIfIOE

public static java.lang.Throwable throwIfIOE(java.lang.Throwable t)
                                      throws java.io.IOException

Helper method that will check if argument is an IOException, and if so, (re)throw it; otherwise just return.

Parameters:

t - the Throwable to possibly propagate

Returns:

the Throwable

Throws:

java.io.IOException - rethrow the IOException

throwRootCauseIfIOE

public static java.lang.Throwable throwRootCauseIfIOE(java.lang.Throwable t)
                                               throws java.io.IOException

Method that works like by calling getRootCause(java.lang.Throwable) and then either throwing it (if instanceof IOException), or return.

Parameters:

t - the Throwable to possibly propagate

Returns:

the Throwable

Throws:

java.io.IOException - rethrow the IOException

throwAsIAE

public static void throwAsIAE(java.lang.Throwable t)

Method that will wrap 't' as an IllegalArgumentException if it is a checked exception; otherwise (runtime exception or error) throw as is.

Parameters:

t - the Throwable to possibly propagate

throwAsIAE

public static void throwAsIAE(java.lang.Throwable t,
                              java.lang.String msg)

Method that will wrap 't' as an IllegalArgumentException (and with specified message) if it is a checked exception; otherwise (runtime exception or error) throw as is.

Parameters:

t - the Throwable to possibly propagate

msg - the detail message

unwrapAndThrowAsIAE

public static void unwrapAndThrowAsIAE(java.lang.Throwable t)

Method that will locate the innermost exception for given Throwable; and then wrap it as an IllegalArgumentException if it is a checked exception; otherwise (runtime exception or error) throw as is

Parameters:

t - the Throwable to possibly propagate

unwrapAndThrowAsIAE

public static void unwrapAndThrowAsIAE(java.lang.Throwable t,
                                       java.lang.String msg)

Method that will locate the innermost exception for given Throwable; and then wrap it as an IllegalArgumentException if it is a checked exception; otherwise (runtime exception or error) throw as is

Parameters:

t - the Throwable to possibly propagate

msg - the detail msg