com.hazelcast.internal.util

Class ExceptionUtil

java.lang.Object

com.hazelcast.internal.util.ExceptionUtil

public final class ExceptionUtil
extends Object

Contains various exception related utility methods.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ExceptionUtil.RuntimeExceptionFactory Interface used by rethrow/peel to wrap the peeled exception

Method Summary

Modifier and Type	Method and Description
static RuntimeException	peel(Throwable t)
static <T extends Throwable> Throwable	peel(Throwable t, Class<T> allowedType, String message) Processes Throwable t so that the returned Throwable's type matches allowedType or RuntimeException.
static <T extends Throwable> Throwable	peel(Throwable t, Class<T> allowedType, String message, ExceptionUtil.RuntimeExceptionFactory runtimeExceptionFactory) Processes Throwable t so that the returned Throwable's type matches allowedType or RuntimeException.
static RuntimeException	rethrow(Throwable t)
static <T extends Throwable> RuntimeException	rethrow(Throwable t, Class<T> allowedType)
static RuntimeException	rethrow(Throwable t, ExceptionUtil.RuntimeExceptionFactory runtimeExceptionFactory)
static <T extends Throwable> RuntimeException	rethrowAllowedTypeFirst(Throwable t, Class<T> allowedType) This rethrow the exception providing an allowed Exception in first priority, even it is a Runtime exception
static RuntimeException	rethrowAllowInterrupted(Throwable t)
static void	rethrowIfError(Throwable t)
static <T extends Throwable> RuntimeException	sneakyThrow(Throwable t)
static String	toString(Throwable cause) Converts a Throwable stacktrace to a String.
static <T> BiConsumer<T,? super Throwable>	withTryCatch(ILogger logger, BiConsumer<T,? super Throwable> consumer) Utility to make sure exceptions inside CompletionStage.whenComplete(BiConsumer) are not swallowed.
static <T> BiConsumer<T,? super Throwable>	withTryCatch(ILogger logger, String message, BiConsumer<T,? super Throwable> consumer) Utility to make sure exceptions inside CompletionStage.whenComplete(BiConsumer) are not swallowed.

Methods inherited from class java.lang.Object

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

Method Detail

toString

public static String toString(Throwable cause)

Converts a Throwable stacktrace to a String.

Parameters:

cause - the Throwable

Returns:

the String.

peel

public static RuntimeException peel(Throwable t)

peel

public static <T extends Throwable> Throwable peel(Throwable t,
                                                   Class<T> allowedType,
                                                   String message)

Processes Throwable t so that the returned Throwable's type matches allowedType or RuntimeException. Processing may include unwrapping t's cause hierarchy, wrapping it in a HazelcastException or just returning the same instance t if it is already an instance of RuntimeException.

Type Parameters:

T - expected type of Throwable

Parameters:

t - Throwable to be peeled

allowedType - the type expected to be returned; when null, this method returns instances of RuntimeException

message - if not null, used as the message in the HazelcastException that may wrap the peeled Throwable

Returns:

the peeled Throwable

peel

public static <T extends Throwable> Throwable peel(Throwable t,
                                                   Class<T> allowedType,
                                                   String message,
                                                   ExceptionUtil.RuntimeExceptionFactory runtimeExceptionFactory)

Processes Throwable t so that the returned Throwable's type matches allowedType or RuntimeException. Processing may include unwrapping t's cause hierarchy, wrapping it in a RuntimeException created by using runtimeExceptionFactory or just returning the same instance t if it is already an instance of RuntimeException.

Type Parameters:

T - expected type of Throwable

Parameters:

t - Throwable to be peeled

allowedType - the type expected to be returned; when null, this method returns instances of RuntimeException

message - if not null, used as the message in RuntimeException that may wrap the peeled Throwable

runtimeExceptionFactory - wraps the peeled code using this runtimeExceptionFactory

Returns:

the peeled Throwable

rethrow

public static RuntimeException rethrow(Throwable t)

rethrow

public static RuntimeException rethrow(Throwable t,
                                       ExceptionUtil.RuntimeExceptionFactory runtimeExceptionFactory)

rethrow

public static <T extends Throwable> RuntimeException rethrow(Throwable t,
                                                             Class<T> allowedType)
                                                      throws T extends Throwable

Throws:

T extends Throwable

rethrowAllowedTypeFirst

public static <T extends Throwable> RuntimeException rethrowAllowedTypeFirst(Throwable t,
                                                                             Class<T> allowedType)
                                                                      throws T extends Throwable

This rethrow the exception providing an allowed Exception in first priority, even it is a Runtime exception

Throws:

T extends Throwable

rethrowIfError

public static void rethrowIfError(Throwable t)

rethrowAllowInterrupted

public static RuntimeException rethrowAllowInterrupted(Throwable t)
                                                throws InterruptedException

Throws:

InterruptedException

sneakyThrow

@Nonnull
public static <T extends Throwable> RuntimeException sneakyThrow(@Nonnull
                                                                          Throwable t)
                                                                   throws T extends Throwable

Throws:

T extends Throwable

withTryCatch

@Nonnull
public static <T> BiConsumer<T,? super Throwable> withTryCatch(@Nonnull
                                                                        ILogger logger,
                                                                        @Nonnull
                                                                        BiConsumer<T,? super Throwable> consumer)

Utility to make sure exceptions inside CompletionStage.whenComplete(BiConsumer) are not swallowed. Exceptions will be caught and logged using the supplied logger.

withTryCatch

@Nonnull
public static <T> BiConsumer<T,? super Throwable> withTryCatch(@Nonnull
                                                                        ILogger logger,
                                                                        @Nonnull
                                                                        String message,
                                                                        @Nonnull
                                                                        BiConsumer<T,? super Throwable> consumer)

Utility to make sure exceptions inside CompletionStage.whenComplete(BiConsumer) are not swallowed. Exceptions will be caught and logged using the supplied logger and message.