Package com.illumon.util

Class MultiException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.illumon.util.MultiException

All Implemented Interfaces:

Serializable

public class MultiException
extends Exception

An exception to use when a series of operations must all be executed, but may all throw exceptions themselves. This allows for retention of all exception data.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static Throwable[]	ZERO_LENGTH_THROWABLE_ARRAY

Constructor Summary

Constructors

Constructor	Description
MultiException(String description, Throwable... causes)	Create a MultiException from an array of Throwable causes.

Method Summary

Modifier and Type	Method	Description
Throwable[]	getCauses()
String	getMessage()
static Exception	maybeWrapInMultiException(String description, Exception... causes)	If there is a single exception, return that exception; otherwise wrap the causes into a MultiException.
static Throwable	maybeWrapInMultiException(String description, Throwable... causes)	If there is a single exception, return that exception; otherwise wrap the causes into a MultiException.
static Throwable	maybeWrapInMultiException(String description, List<? extends Throwable> causes)	If there is a single exception, return that exception; otherwise wrap the causes into a MultiException.
void	printStackTrace(PrintStream s)
void	printStackTrace(PrintWriter s)
String	toString()

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

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

Field Details

ZERO_LENGTH_THROWABLE_ARRAY

public static final Throwable[] ZERO_LENGTH_THROWABLE_ARRAY

Constructor Details

MultiException

public MultiException(String description, Throwable... causes)

Create a MultiException from an array of Throwable causes.

Parameters:

description - the message to use

causes - a list of causes

Method Details

maybeWrapInMultiException

public static Throwable maybeWrapInMultiException(String description, Throwable... causes)

If there is a single exception, return that exception; otherwise wrap the causes into a MultiException.

Parameters:

description - the description for the MultiException

causes - the array of causes

Returns:

a MultiException or the single Throwable

maybeWrapInMultiException

public static Throwable maybeWrapInMultiException(String description, List<? extends Throwable> causes)

If there is a single exception, return that exception; otherwise wrap the causes into a MultiException.

Parameters:

description - the description for the MultiException

causes - the list of causes

Returns:

a MultiException or the single Throwable

maybeWrapInMultiException

public static Exception maybeWrapInMultiException(String description, Exception... causes)

If there is a single exception, return that exception; otherwise wrap the causes into a MultiException.

Parameters:

description - the description for the MultiException

causes - the array of causes

Returns:

a MultiException or the single Exception

getCauses

public Throwable[] getCauses()

Returns:

all of the exceptions that resulted in this one.

printStackTrace

public void printStackTrace(PrintWriter s)

Overrides:

printStackTrace in class Throwable

printStackTrace

public void printStackTrace(PrintStream s)

Overrides:

printStackTrace in class Throwable

getMessage

public String getMessage()

Overrides:

getMessage in class Throwable

toString

public String toString()

Overrides:

toString in class Throwable