rx.exceptions

Class Exceptions

java.lang.Object

rx.exceptions.Exceptions

public final class Exceptions
extends java.lang.Object

Utility class with methods to wrap checked exceptions and manage fatal and regular exception delivery.

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) Convenience method to throw a RuntimeException and Error directly or wrap any other exception type into a RuntimeException.
static void	throwIfAny(java.util.List<? extends java.lang.Throwable> exceptions) Throws a single or multiple exceptions contained in the collection, wrapping it into CompositeException if necessary.
static void	throwIfFatal(java.lang.Throwable t) Throws a particular Throwable only if it belongs to a set of "fatal" error varieties.
static void	throwOrReport(java.lang.Throwable t, Observer<?> o) Forwards a fatal exception or reports it to the given Observer.
static void	throwOrReport(java.lang.Throwable t, Observer<?> o, java.lang.Object value) Forwards a fatal exception or reports it along with the value caused it to the given Observer.
static void	throwOrReport(java.lang.Throwable throwable, SingleSubscriber<?> subscriber) Forwards a fatal exception or reports it to the given Observer.
static void	throwOrReport(java.lang.Throwable t, SingleSubscriber<?> o, java.lang.Object value) Forwards a fatal exception or reports it along with the value caused it to the given SingleSubscriber.

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)

Convenience method to throw a RuntimeException and Error directly or wrap any other exception type into a RuntimeException.

Parameters:

t - the exception to throw directly or wrapped

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
• OnCompletedFailedException
• 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)

throwIfAny

public static void throwIfAny(java.util.List<? extends java.lang.Throwable> exceptions)

Throws a single or multiple exceptions contained in the collection, wrapping it into CompositeException if necessary.

Parameters:

exceptions - the collection of exceptions. If null or empty, no exception is thrown. If the collection contains a single exception, that exception is either thrown as-is or wrapped into a CompositeException. Multiple exceptions are wrapped into a CompositeException.

Since:

1.1.0

throwOrReport

@Beta
public static void throwOrReport(java.lang.Throwable t,
                      Observer<?> o,
                      java.lang.Object value)

Forwards a fatal exception or reports it along with the value caused it to the given Observer.

Parameters:

t - the exception

o - the observer to report to

value - the value that caused the exception

Since:

(if this graduates from Experimental/Beta to supported, replace this parenthetical with the release number)

throwOrReport

@Beta
public static void throwOrReport(java.lang.Throwable t,
                      SingleSubscriber<?> o,
                      java.lang.Object value)

Forwards a fatal exception or reports it along with the value caused it to the given SingleSubscriber.

Parameters:

t - the exception

o - the observer to report to

value - the value that caused the exception

Since:

(if this graduates from Experimental/Beta to supported, replace this parenthetical with the release number)

throwOrReport

@Beta
public static void throwOrReport(java.lang.Throwable t,
                      Observer<?> o)

Forwards a fatal exception or reports it to the given Observer.

Parameters:

t - the exception

o - the observer to report to

Since:

(if this graduates from Experimental/Beta to supported, replace this parenthetical with the release number)

throwOrReport

@Beta
public static void throwOrReport(java.lang.Throwable throwable,
                      SingleSubscriber<?> subscriber)

Forwards a fatal exception or reports it to the given Observer.

Parameters:

throwable - the exception.

subscriber - the subscriber to report to.

Since:

(if this graduates from Experimental/Beta to supported, replace this parenthetical with the release number).