reactor.core

Class Exceptions

java.lang.Object

reactor.core.Exceptions

public abstract class Exceptions
extends java.lang.Object

Global Reactor Core Exception handling and utils to operate on.

See Also:

Reactive-Streams-Commons

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	CANCEL_STACKTRACE
static java.lang.Throwable	TERMINATED A singleton instance of a Throwable indicating a terminal state for exceptions, don't leak this!

Method Summary

Modifier and Type	Method and Description
static <T> boolean	addThrowable(java.util.concurrent.atomic.AtomicReferenceFieldUpdater<T,java.lang.Throwable> field, T instance, java.lang.Throwable exception)
static java.lang.NullPointerException	argumentIsNullException()
static java.lang.RuntimeException	bubble(java.lang.Throwable t) Return an unchecked RuntimeException to be thrown that will bubble upstream.
static java.lang.IllegalStateException	duplicateOnSubscribeException()
static java.lang.RuntimeException	failWithCancel() An exception that is propagated upward and considered as "fatal" as per Reactive Stream limited list of exceptions allowed to bubble.
static java.lang.IllegalStateException	failWithOverflow() Return an IllegalStateException
static boolean	isBubbling(java.lang.Throwable t) Check if the given error is a bubbled wrapped exception.
static boolean	isCancel(java.lang.Throwable t) Check if the given error is a cancel signal.
static java.lang.IllegalArgumentException	nullOrNegativeRequestException(long elements)
static java.lang.RuntimeException	propagate(java.lang.Throwable t) Return an unchecked RuntimeException to be thrown that will be propagated downstream through Subscriber.onError(Throwable).
static <T> java.lang.Throwable	terminate(java.util.concurrent.atomic.AtomicReferenceFieldUpdater<T,java.lang.Throwable> field, T instance) Atomic utility to safely mark a volatile throwable reference with a terminal marker.
static void	throwIfFatal(java.lang.Throwable t) Throws a particular Throwable only if it belongs to a set of "fatal" error varieties.
static java.lang.Throwable	unwrap(java.lang.Throwable t) Unwrap a particular Throwable only if it is a wrapped exception via bubble(java.lang.Throwable) or propagate(java.lang.Throwable).

Methods inherited from class java.lang.Object

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

Field Detail

CANCEL_STACKTRACE

public static final boolean CANCEL_STACKTRACE

TERMINATED

public static final java.lang.Throwable TERMINATED

A singleton instance of a Throwable indicating a terminal state for exceptions, don't leak this!

Method Detail

addThrowable

public static <T> boolean addThrowable(java.util.concurrent.atomic.AtomicReferenceFieldUpdater<T,java.lang.Throwable> field,
                                       T instance,
                                       java.lang.Throwable exception)

Type Parameters:

T - the parent instance type

Parameters:

field - the target field updater

instance - the parent instance for the field

exception - the Throwable to add.

Returns:

true if added, false if the field contained the TERMINATED instance.

argumentIsNullException

public static java.lang.NullPointerException argumentIsNullException()

Returns:

a new NullPointerException with a cause message abiding to reactive stream specification.

bubble

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

Return an unchecked RuntimeException to be thrown that will bubble upstream.

This method invokes throwIfFatal(Throwable).

Parameters:

t - the root cause

Returns:

an unchecked exception that should choose bubbling up over error callback path

duplicateOnSubscribeException

public static java.lang.IllegalStateException duplicateOnSubscribeException()

Returns:

a new IllegalStateException with a cause message abiding to reactive stream specification.

failWithCancel

public static java.lang.RuntimeException failWithCancel()

An exception that is propagated upward and considered as "fatal" as per Reactive Stream limited list of exceptions allowed to bubble. It is not meant to be common error resolution but might assist implementors in dealing with boundaries (queues, combinations and async).

Returns:

a RuntimeException that can be checked via isCancel(java.lang.Throwable)

failWithOverflow

public static java.lang.IllegalStateException failWithOverflow()

Return an IllegalStateException

Returns:

an IllegalStateException

isCancel

public static boolean isCancel(java.lang.Throwable t)

Check if the given error is a cancel signal.

Parameters:

t - the Throwable error to check

Returns:

true if given error is a cancellation token.

isBubbling

public static boolean isBubbling(java.lang.Throwable t)

Check if the given error is a bubbled wrapped exception.

Parameters:

t - the Throwable error to check

Returns:

true if given error is a a bubbled wrapped exception.

nullOrNegativeRequestException

public static java.lang.IllegalArgumentException nullOrNegativeRequestException(long elements)

Parameters:

elements - the invalid requested demand

Returns:

a new IllegalArgumentException with a cause message abiding to reactive stream specification.

propagate

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

Return an unchecked RuntimeException to be thrown that will be propagated downstream through Subscriber.onError(Throwable).

This method invokes throwIfFatal(Throwable).

Parameters:

t - the root cause

Returns:

an unchecked exception

terminate

public static <T> java.lang.Throwable terminate(java.util.concurrent.atomic.AtomicReferenceFieldUpdater<T,java.lang.Throwable> field,
                                                T instance)

Atomic utility to safely mark a volatile throwable reference with a terminal marker.

Type Parameters:

T - the instance type

Parameters:

field - the atomic container

instance - the reference instance

Returns:

the previously masked throwable

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:

• BubblingException
• StackOverflowError
• VirtualMachineError
• ThreadDeath
• LinkageError

Parameters:

t - the exception to evaluate

unwrap

public static java.lang.Throwable unwrap(java.lang.Throwable t)

Unwrap a particular Throwable only if it is a wrapped exception via bubble(java.lang.Throwable) or propagate(java.lang.Throwable).

Parameters:

t - the exception to wrap

Returns:

the unwrapped exception