Package org.elasticsearch

Class ExceptionsHelper

java.lang.Object

org.elasticsearch.ExceptionsHelper

public final class ExceptionsHelper
extends Object

Constructor Summary

Constructors

Constructor	Description
ExceptionsHelper()

Method Summary

Modifier and Type	Method	Description
static ElasticsearchException	convertToElastic(Exception e)
static RuntimeException	convertToRuntime(Exception e)
static String	detailedMessage(Throwable t)	Deprecated. Don't swallow exceptions, allow them to propagate.
static String	formatStackTrace(StackTraceElement[] stackTrace)
static ShardOperationFailedException[]	groupBy(ShardOperationFailedException[] failures)	Deduplicate the failures by exception message and index.
static boolean	isTransportStoppedForAction(Throwable t, String action)
static void	maybeDieOnAnotherThread(Throwable throwable)	If the specified cause is an unrecoverable error, this method will rethrow the cause on a separate thread so that it can not be caught and bubbles up to the uncaught exception handler.
static Optional<Error>	maybeError(Throwable cause)	Unwrap the specified throwable looking for any suppressed errors or errors as a root cause of the specified throwable.
static <T extends Throwable> void	maybeThrowRuntimeAndSuppress(List<T> exceptions)	Throws a runtime exception with all given exceptions added as suppressed.
static <T extends Throwable> void	rethrowAndSuppress(List<T> exceptions)	Rethrows the first exception in the list and adds all remaining to the suppressed list.
static boolean	reThrowIfNotNull(Throwable e)	Throws the specified exception.
static String	stackTrace(Throwable e)
static RestStatus	status(Throwable t)
static Throwable	unwrap(Throwable t, Class<?>... clazzes)	Looks at the given Throwable and its cause(s) and returns the first Throwable that is of one of the given classes or null if no matching Throwable is found.
static Throwable	unwrapCause(Throwable t)
static IOException	unwrapCorruption(Throwable t)	Looks at the given Throwable's and its cause(s) as well as any suppressed exceptions on the Throwable as well as its causes and returns the first corruption indicating exception (as defined by CORRUPTION_EXCEPTIONS) it finds.
static <T extends Throwable> T	useOrSuppress(T first, T second)

Methods inherited from class java.lang.Object

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

Constructor Detail

ExceptionsHelper

public ExceptionsHelper()

Method Detail

convertToRuntime

public static RuntimeException convertToRuntime(Exception e)

convertToElastic

public static ElasticsearchException convertToElastic(Exception e)

status

public static RestStatus status(Throwable t)

unwrapCause

public static Throwable unwrapCause(Throwable t)

detailedMessage

@Deprecated
public static String detailedMessage(Throwable t)

Deprecated.

Don't swallow exceptions, allow them to propagate.

stackTrace

public static String stackTrace(Throwable e)

formatStackTrace

public static String formatStackTrace(StackTraceElement[] stackTrace)

rethrowAndSuppress

public static <T extends Throwable> void rethrowAndSuppress(List<T> exceptions)
                                                     throws T extends Throwable

Rethrows the first exception in the list and adds all remaining to the suppressed list. If the given list is empty no exception is thrown

Throws:

T extends Throwable

maybeThrowRuntimeAndSuppress

public static <T extends Throwable> void maybeThrowRuntimeAndSuppress(List<T> exceptions)

Throws a runtime exception with all given exceptions added as suppressed. If the given list is empty no exception is thrown

useOrSuppress

public static <T extends Throwable> T useOrSuppress(T first,
                                                    T second)

unwrapCorruption

public static IOException unwrapCorruption(Throwable t)

Looks at the given Throwable's and its cause(s) as well as any suppressed exceptions on the Throwable as well as its causes and returns the first corruption indicating exception (as defined by CORRUPTION_EXCEPTIONS) it finds.

Parameters:

t - Throwable

Returns:

Corruption indicating exception if one is found, otherwise null

unwrap

public static Throwable unwrap(Throwable t,
                               Class<?>... clazzes)

Looks at the given Throwable and its cause(s) and returns the first Throwable that is of one of the given classes or null if no matching Throwable is found. Unlike unwrapCorruption(java.lang.Throwable) this method does only check the given Throwable and its causes but does not look at any suppressed exceptions.

Parameters:

t - Throwable

clazzes - Classes to look for

Returns:

Matching Throwable if one is found, otherwise null

isTransportStoppedForAction

public static boolean isTransportStoppedForAction(Throwable t,
                                                  String action)

reThrowIfNotNull

public static boolean reThrowIfNotNull(@Nullable
                                       Throwable e)

Throws the specified exception. If null if specified then true is returned.

maybeError

public static Optional<Error> maybeError(Throwable cause)

Unwrap the specified throwable looking for any suppressed errors or errors as a root cause of the specified throwable.

Parameters:

cause - the root throwable

Returns:

an optional error if one is found suppressed or a root cause in the tree rooted at the specified throwable

maybeDieOnAnotherThread

public static void maybeDieOnAnotherThread(Throwable throwable)

If the specified cause is an unrecoverable error, this method will rethrow the cause on a separate thread so that it can not be caught and bubbles up to the uncaught exception handler. Note that the cause tree is examined for any Error. See maybeError(Throwable) for the semantics.

Parameters:

throwable - the throwable to possibly throw on another thread

groupBy

public static ShardOperationFailedException[] groupBy(ShardOperationFailedException[] failures)

Deduplicate the failures by exception message and index.