rx.exceptions

Class Exceptions

java.lang.Object

rx.exceptions.Exceptions

public final class Exceptions
extends java.lang.Object

Method Summary

Methods

Modifier and Type	Method and Description
static void	addCause(java.lang.Throwable e, java.lang.Throwable cause) Adds a Throwable to a causality-chain of Throwables, as an additional cause (if it does not already appear in the chain among the causes).
static java.lang.Throwable	getFinalCause(java.lang.Throwable e) Get the Throwable at the end of the causality-chain for a particular Throwable
static java.lang.RuntimeException	propagate(java.lang.Throwable t)
static void	throwIfFatal(java.lang.Throwable t) Throws a particular Throwable only if it belongs to a set of "fatal" error varieties.

Methods inherited from class java.lang.Object

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

Method Detail

propagate

public static java.lang.RuntimeException propagate(java.lang.Throwable t)

Returns:

because propagate itself throws an exception or error, this is a sort of phantom return value; propagate does not actually return anything

throwIfFatal

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

Throws a particular Throwable only if it belongs to a set of "fatal" error varieties. These varieties are as follows:

• OnErrorNotImplementedException
• OnErrorFailedException
• StackOverflowError
• VirtualMachineError
• ThreadDeath
• LinkageError

This can be useful if you are writing an operator that calls user-supplied code, and you want to notify subscribers of errors encountered in that code by calling their onError methods, but only if the errors are not so catastrophic that such a call would be futile, in which case you simply want to rethrow the error.

Parameters:

t - the Throwable to test and perhaps throw

See Also:

RxJava: StackOverflowError is swallowed (Issue #748)

addCause

public static void addCause(java.lang.Throwable e,
            java.lang.Throwable cause)

Adds a Throwable to a causality-chain of Throwables, as an additional cause (if it does not already appear in the chain among the causes).

Parameters:

e - the Throwable at the head of the causality chain

cause - the Throwable you want to add as a cause of the chain

getFinalCause

public static java.lang.Throwable getFinalCause(java.lang.Throwable e)

Get the Throwable at the end of the causality-chain for a particular Throwable

Parameters:

e - the Throwable whose final cause you are curious about

Returns:

the last Throwable in the causality-chain of e (or a "Stack too deep to get final cause" RuntimeException if the chain is too long to traverse)