public final class Exceptions
extends Object 

• Method Summary

  All Methods

  Modifier and Type	Method and Description
  static @NonNull RuntimeException	propagate (@NonNull Throwable t) Convenience method to throw a RuntimeException and Error directly or wrap any other exception type into a RuntimeException.
  static void	throwIfFatal (@NonNull 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

    @NonNull
    public static @NonNull RuntimeException propagate(@NonNull
     @NonNull 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(@NonNull
     @NonNull Throwable t)

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

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