Package org.eclipse.jetty.util

Class MultiException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.eclipse.jetty.util.MultiException

All Implemented Interfaces:

Serializable

public class MultiException
extends Exception

Wraps multiple exceptions. Allows multiple exceptions to be thrown as a single exception. The MultiException itself should not be thrown instead one of the ifExceptionThrow* methods should be called instead.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
MultiException()

Method Summary

Modifier and Type	Method	Description
void	add(Throwable e)
Throwable	getThrowable(int i)
List<Throwable>	getThrowables()
void	ifExceptionThrow()	Throw a multiexception.
void	ifExceptionThrowMulti()	Throw a multiexception.
void	ifExceptionThrowRuntime()	Throw a Runtime exception.
void	ifExceptionThrowSuppressed()	Throw an Exception, potentially with suppress.
int	size()
String	toString()

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Details

MultiException

public MultiException()

Method Details

add

public void add(Throwable e)

size

public int size()

getThrowables

public List<Throwable> getThrowables()

getThrowable

public Throwable getThrowable(int i)

ifExceptionThrow

public void ifExceptionThrow()
                      throws Exception

Throw a multiexception. If this multi exception is empty then no action is taken. If it contains a single exception that is thrown, otherwise the this multi exception is thrown.

Throws:

Exception - the Error or Exception if nested is 1, or the MultiException itself if nested is more than 1.

ifExceptionThrowRuntime

public void ifExceptionThrowRuntime()
                             throws Error

Throw a Runtime exception. If this multi exception is empty then no action is taken. If it contains a single error or runtime exception that is thrown, otherwise the this multi exception is thrown, wrapped in a runtime exception.

Throws:

Error - If this exception contains exactly 1 Error

RuntimeException - If this exception contains 1 Throwable but it is not an error, or it contains more than 1 Throwable of any type.

ifExceptionThrowMulti

public void ifExceptionThrowMulti()
                           throws MultiException

Throw a multiexception. If this multi exception is empty then no action is taken. If it contains a any exceptions then this multi exception is thrown.

Throws:

MultiException - the multiexception if there are nested exception

ifExceptionThrowSuppressed

public void ifExceptionThrowSuppressed()
                                throws Exception

Throw an Exception, potentially with suppress. If this multi exception is empty then no action is taken. If the first exception added is an Error or Exception, then it is throw with any additional exceptions added as suppressed. Otherwise a MultiException is thrown, with all exceptions added as suppressed.

Throws:

Exception - the Error or Exception if at least one is added.

toString

public String toString()

Overrides:

toString in class Throwable