Module dev.metaschema.core

Package dev.metaschema.core.util

Class ExceptionUtils

java.lang.Object

dev.metaschema.core.util.ExceptionUtils

public final class ExceptionUtils
extends Object

Provides a means for throwing important checked exceptions over non-checked methods, e.g. lambda invocations.

This capability should be used with care, and generally in limited circumstances.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	ExceptionUtils.WrappedException	A runtime exception that wraps a checked exception, allowing it to be thrown from contexts that do not allow checked exceptions (such as lambda expressions).

Method Summary

Modifier and Type	Method	Description
static Throwable	unwrap(ExceptionUtils.WrappedException ex)	Unwrap a previously wrapped exception.
static <E extends Throwable> E	unwrap(ExceptionUtils.WrappedException ex, Class<E> wrappedExceptionClass)	Unwrap a previously wrapped exception, casting it to the expected type.
static ExceptionUtils.WrappedException	wrap(Throwable ex)	Wrap a checked exception in an unchecked ExceptionUtils.WrappedException.
static ExceptionUtils.WrappedException	wrapAndThrow(Throwable ex)	Wrap a checked exception in an unchecked ExceptionUtils.WrappedException.

Methods inherited from class java.lang.Object

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

Method Details

wrap

@NonNull
public static ExceptionUtils.WrappedException wrap(@NonNull
 Throwable ex)

Wrap a checked exception in an unchecked ExceptionUtils.WrappedException.

Parameters:

ex - the exception to wrap

Returns:

a new wrapped exception containing the provided exception

wrapAndThrow

@NonNull
public static ExceptionUtils.WrappedException wrapAndThrow(@NonNull
 Throwable ex)

Wrap a checked exception in an unchecked ExceptionUtils.WrappedException.

This method is identical to wrap(Throwable) but named to indicate intent when used in throw statements.

Parameters:

ex - the exception to wrap

Returns:

a new wrapped exception containing the provided exception

unwrap

@NonNull
public static Throwable unwrap(@NonNull
 ExceptionUtils.WrappedException ex)

Unwrap a previously wrapped exception.

Parameters:

ex - the wrapped exception to unwrap

Returns:

the original exception that was wrapped

unwrap

@NonNull
public static <E extends Throwable> E unwrap(@NonNull
 ExceptionUtils.WrappedException ex,
 @NonNull
 Class<E> wrappedExceptionClass)

Unwrap a previously wrapped exception, casting it to the expected type.

Type Parameters:

E - the expected exception type

Parameters:

ex - the wrapped exception to unwrap

wrappedExceptionClass - the class of the expected exception type

Returns:

the original exception cast to the expected type

Throws:

IllegalArgumentException - if the wrapped exception is not of the expected type