CompositeException

rx.exceptions

Class CompositeException

java.lang.Object
- java.lang.Throwable
- - java.lang.Exception
  - - java.lang.RuntimeException
    - - rx.exceptions.CompositeException

All Implemented Interfaces:

Serializable
```
public final class CompositeException
extends 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 composit 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(Collection<? extends Throwable> errors)`
`CompositeException(String messagePrefix, Collection<? extends Throwable> errors)`

Method Summary

All Methods

Instance Methods

Concrete Methods
Modifier and Type	Method and Description
`Throwable`	`getCause()`
`List<Throwable>`	`getExceptions()` Retrieves the list of exceptions that make up the `CompositeException`
`String`	`getMessage()`
`void`	`printStackTrace()` All of the following `printStackTrace` functionality is derived from JDK `Throwable` `printStackTrace`.
`void`	`printStackTrace(PrintStream s)`
`void`	`printStackTrace(PrintWriter s)`

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(String messagePrefix,
                          Collection<? extends Throwable> errors)
```
  - CompositeException
```
public CompositeException(Collection<? extends Throwable> errors)
```
- Method Detail
  - getExceptions
```
public List<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 String getMessage()
```
  - getCause
```
public Throwable getCause()
```
  - 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
  - printStackTrace
```
public void printStackTrace(PrintStream s)
```
  - printStackTrace
```
public void printStackTrace(PrintWriter s)
```