io.reactivex.exceptions

Class CompositeException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

io.reactivex.exceptions.CompositeException

All Implemented Interfaces:

java.io.Serializable

public final class CompositeException
extends java.lang.RuntimeException

Represents an exception that is a composite of one or more other exceptions. A CompositeException does not modify the structure of any exception it wraps, but at print-time it iterates through the list of Throwables contained in the composite in order to print them all. Its invariant is to contain an immutable, ordered (by insertion order), unique list of non-composite exceptions. You can retrieve individual exceptions in this list with getExceptions(). The printStackTrace() implementation handles the StackTrace in a customized way instead of using getCause() so that it can avoid circular references. If you invoke getCause(), it will lazily create the causal chain but will stop if it finds any Throwable in the chain that it has already seen.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
CompositeException() Constructs an empty CompositeException.
CompositeException(java.lang.Iterable<? extends java.lang.Throwable> errors) Constructs a CompositeException with the given array of Throwables as the list of suppressed exceptions.
CompositeException(java.lang.Throwable... exceptions) Constructs a CompositeException with the given array of Throwables as the list of suppressed exceptions.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Throwable	getCause()
java.util.List<java.lang.Throwable>	getExceptions() Retrieves the list of exceptions that make up the CompositeException.
java.lang.String	getMessage()
boolean	isEmpty() Returns true if this CompositeException doesn't have a cause or any suppressed exceptions.
void	printStackTrace() All of the following printStackTrace functionality is derived from JDK Throwable printStackTrace.
void	printStackTrace(java.io.PrintStream s)
void	printStackTrace(java.io.PrintWriter s)
int	size() Returns the number of suppressed exceptions.
void	suppress(java.lang.Throwable e) Adds a suppressed exception to this composite.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, initCause, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

CompositeException

public CompositeException()

Constructs an empty CompositeException.

CompositeException

public CompositeException(java.lang.Throwable... exceptions)

Constructs a CompositeException with the given array of Throwables as the list of suppressed exceptions.

Parameters:

exceptions - the Throwables to have as initially suppressed exceptions

CompositeException

public CompositeException(java.lang.Iterable<? extends java.lang.Throwable> errors)

Constructs a CompositeException with the given array of Throwables as the list of suppressed exceptions.

Parameters:

errors - the Throwables to have as initially suppressed exceptions

Method Detail

getExceptions

public java.util.List<java.lang.Throwable> getExceptions()

Retrieves the list of exceptions that make up the CompositeException.

Returns:

the exceptions that make up the CompositeException, as a List of Throwables

getMessage

public java.lang.String getMessage()

Overrides:

getMessage in class java.lang.Throwable

suppress

public void suppress(java.lang.Throwable e)

Adds a suppressed exception to this composite.

The method is named this way to avoid conflicts with Java 7 environments and its addSuppressed() method.

Parameters:

e - the exception to suppress, nulls are converted to NullPointerExceptions

getCause

public java.lang.Throwable getCause()

Overrides:

getCause in class java.lang.Throwable

printStackTrace

public void printStackTrace()

All of the following printStackTrace functionality is derived from JDK Throwable printStackTrace. In particular, the PrintStreamOrWriter abstraction is copied wholesale. Changes from the official JDK implementation:

• no infinite loop detection
• smaller critical section holding PrintStream lock
• explicit knowledge about the exceptions List that this loops through

Overrides:

printStackTrace in class java.lang.Throwable

printStackTrace

public void printStackTrace(java.io.PrintStream s)

Overrides:

printStackTrace in class java.lang.Throwable

printStackTrace

public void printStackTrace(java.io.PrintWriter s)

Overrides:

printStackTrace in class java.lang.Throwable

size

public int size()

Returns the number of suppressed exceptions.

Returns:

the number of suppressed exceptions

isEmpty

public boolean isEmpty()

Returns true if this CompositeException doesn't have a cause or any suppressed exceptions.

Returns:

true if this CompositeException doesn't have a cause or any suppressed exceptions.