org.apache.flink.util

Class ExceptionUtils

java.lang.Object

org.apache.flink.util.ExceptionUtils

@Internal
public final class ExceptionUtils
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static String	STRINGIFIED_NULL_EXCEPTION

Method Summary

Methods

Modifier and Type	Method and Description
static <T extends Throwable> T	firstOrSuppressed(T newException, T previous) Adds a new exception as a suppressed exception to a prior exception, or returns the new exception, if no prior exception exists.
static void	rethrow(Throwable t) Throws the given Throwable in scenarios where the signatures do not allow you to throw an arbitrary Throwable.
static void	rethrow(Throwable t, String parentMessage) Throws the given Throwable in scenarios where the signatures do not allow you to throw an arbitrary Throwable.
static void	rethrowException(Throwable t, String parentMessage) Throws the given Throwable in scenarios where the signatures do allow to throw a Exception.
static void	rethrowIOException(Throwable t) Re-throws the given Throwable in scenarios where the signatures allows only IOExceptions (and RuntimeException and Error).
static String	stringifyException(Throwable e) Makes a string representation of the exception's stack trace, or "(null)", if the exception is null.
static void	tryRethrowIOException(Throwable t) Tries to throw the given Throwable in scenarios where the signatures allows only IOExceptions (and RuntimeException and Error).

Methods inherited from class java.lang.Object

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

Field Detail

STRINGIFIED_NULL_EXCEPTION

public static final String STRINGIFIED_NULL_EXCEPTION

See Also:

Constant Field Values

Method Detail

stringifyException

public static String stringifyException(Throwable e)

Makes a string representation of the exception's stack trace, or "(null)", if the exception is null. This method makes a best effort and never fails.

Parameters:

e - The exception to stringify.

Returns:

A string with exception name and call stack.

firstOrSuppressed

public static <T extends Throwable> T firstOrSuppressed(T newException,
                                        @Nullable
                                        T previous)

Adds a new exception as a suppressed exception to a prior exception, or returns the new exception, if no prior exception exists.

public void closeAllThings() throws Exception {
     Exception ex = null;
     try {
         component.shutdown();
     } catch (Exception e) {
         ex = firstOrSuppressed(e, ex);
     }
     try {
         anotherComponent.stop();
     } catch (Exception e) {
         ex = firstOrSuppressed(e, ex);
     }
     try {
         lastComponent.shutdown();
     } catch (Exception e) {
         ex = firstOrSuppressed(e, ex);
     }

     if (ex != null) {
         throw ex;
     }
 }
 

Parameters:

newException - The newly occurred exception

previous - The previously occurred exception, possibly null.

Returns:

The new exception, if no previous exception exists, or the previous exception with the new exception in the list of suppressed exceptions.

rethrow

public static void rethrow(Throwable t)

Throws the given Throwable in scenarios where the signatures do not allow you to throw an arbitrary Throwable. Errors and RuntimeExceptions are thrown directly, other exceptions are packed into runtime exceptions

Parameters:

t - The throwable to be thrown.

rethrow

public static void rethrow(Throwable t,
           String parentMessage)

Throws the given Throwable in scenarios where the signatures do not allow you to throw an arbitrary Throwable. Errors and RuntimeExceptions are thrown directly, other exceptions are packed into a parent RuntimeException.

Parameters:

t - The throwable to be thrown.

parentMessage - The message for the parent RuntimeException, if one is needed.

rethrowException

public static void rethrowException(Throwable t,
                    String parentMessage)
                             throws Exception

Throws the given Throwable in scenarios where the signatures do allow to throw a Exception. Errors and Exceptions are thrown directly, other "exotic" subclasses of Throwable are wrapped in an Exception.

Parameters:

t - The throwable to be thrown.

parentMessage - The message for the parent Exception, if one is needed.

Throws:

Exception

tryRethrowIOException

public static void tryRethrowIOException(Throwable t)
                                  throws IOException

Tries to throw the given Throwable in scenarios where the signatures allows only IOExceptions (and RuntimeException and Error). Throws this exception directly, if it is an IOException, a RuntimeException, or an Error. Otherwise does nothing.

Parameters:

t - The Throwable to be thrown.

Throws:

IOException

rethrowIOException

public static void rethrowIOException(Throwable t)
                               throws IOException

Re-throws the given Throwable in scenarios where the signatures allows only IOExceptions (and RuntimeException and Error). Throws this exception directly, if it is an IOException, a RuntimeException, or an Error. Otherwise it wraps it in an IOException and throws it.

Parameters:

t - The Throwable to be thrown.

Throws:

IOException