Module com.aoapps.lang

Package com.aoapps.lang.exception

Class WrappedException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.aoapps.lang.exception.WrappedException

All Implemented Interfaces:

ExtraInfo, Serializable

public class WrappedException
extends RuntimeException
implements ExtraInfo

A wrapped exception may be used to rethrow checked exceptions in a context where they are otherwise not allowed.

This could be accomplished by rethrowing with RuntimeException directly, but having this distinct class provides more meaning as well as the ability to catch wrapped exceptions while letting all other runtime exceptions go through directly.

Catching WrappedException may be used to unwrap expected throwable types.

Author:

AO Industries, Inc.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
WrappedException()	Deprecated. Please provide cause.
WrappedException(IOException cause)	Deprecated. Please use UncheckedIOException.
WrappedException(IOException cause, Object... extraInfo)	Deprecated. Please use UncheckedIOException.
WrappedException(String message)	Deprecated. Please provide cause.
WrappedException(String message, IOException cause)	Deprecated. Please use UncheckedIOException.
WrappedException(String message, IOException cause, Object... extraInfo)	Deprecated. Please use UncheckedIOException.
WrappedException(String message, Throwable cause)	Uses extra info of the original cause when it is an ExtraInfo.
WrappedException(String message, Throwable cause, Object... extraInfo)
WrappedException(Throwable cause)	Uses extra info of the original cause when it is an ExtraInfo.
WrappedException(Throwable cause, Object... extraInfo)

Method Summary

Modifier and Type	Method	Description
static <V> V	call(Callable<V> callable)	Invokes the given callable, wrapping any checked exceptions.
static <V> V	call(Callable<V> callable, Object... extraInfo)	Invokes the given callable, wrapping any checked exceptions.
static <V> V	call(Callable<V> callable, String message)	Invokes the given callable, wrapping any checked exceptions.
static <V> V	call(Callable<V> callable, String message, Object... extraInfo)	Invokes the given callable, wrapping any checked exceptions.
static <V> V	callE(CallableE<V,?> callable)	Invokes the given callable, wrapping any checked exceptions.
static <V> V	callE(CallableE<V,?> callable, Object... extraInfo)	Invokes the given callable, wrapping any checked exceptions.
static <V> V	callE(CallableE<V,?> callable, String message)	Invokes the given callable, wrapping any checked exceptions.
static <V> V	callE(CallableE<V,?> callable, String message, Object... extraInfo)	Invokes the given callable, wrapping any checked exceptions.
Object[]	getExtraInfo()	Gets the optional extra info associated with an exception.
String	getLocalizedMessage()
String	getMessage()
static void	runE(RunnableE<?> runnable)	Invokes the given runnable, wrapping any checked exceptions.
static void	runE(RunnableE<?> runnable, Object... extraInfo)	Invokes the given runnable, wrapping any checked exceptions.
static void	runE(RunnableE<?> runnable, String message)	Invokes the given runnable, wrapping any checked exceptions.
static void	runE(RunnableE<?> runnable, String message, Object... extraInfo)	Invokes the given runnable, wrapping any checked exceptions.
static <V> V	wrapChecked(Callable<V> callable)	Deprecated. Please use call(java.util.concurrent.Callable)
static <V> V	wrapChecked(Callable<V> callable, Object... extraInfo)	Deprecated. Please use call(java.util.concurrent.Callable, java.lang.Object...)
static <V> V	wrapChecked(Callable<V> callable, String message)	Deprecated. Please use call(java.util.concurrent.Callable, java.lang.String)
static <V> V	wrapChecked(Callable<V> callable, String message, Object... extraInfo)	Deprecated. Please use call(java.util.concurrent.Callable, java.lang.String, java.lang.Object...)

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Details

WrappedException

@Deprecated
public WrappedException()

Deprecated.

Please provide cause.

WrappedException

@Deprecated
public WrappedException(String message)

Deprecated.

Please provide cause.

WrappedException

public WrappedException(Throwable cause)

Uses extra info of the original cause when it is an ExtraInfo.

WrappedException

@Deprecated
public WrappedException(IOException cause)

Deprecated.

Please use UncheckedIOException.

WrappedException

public WrappedException(Throwable cause,
 Object... extraInfo)

Parameters:

extraInfo - No defensive copy

WrappedException

@Deprecated
public WrappedException(IOException cause,
 Object... extraInfo)

Deprecated.

Please use UncheckedIOException.

WrappedException

public WrappedException(String message,
 Throwable cause)

Uses extra info of the original cause when it is an ExtraInfo.

WrappedException

@Deprecated
public WrappedException(String message,
 IOException cause)

Deprecated.

Please use UncheckedIOException.

WrappedException

public WrappedException(String message,
 Throwable cause,
 Object... extraInfo)

Parameters:

extraInfo - No defensive copy

WrappedException

@Deprecated
public WrappedException(String message,
 IOException cause,
 Object... extraInfo)

Deprecated.

Please use UncheckedIOException.

Method Details

call

public static <V> V call(Callable<V> callable)

Invokes the given callable, wrapping any checked exceptions.

wrapChecked

@Deprecated
public static <V> V wrapChecked(Callable<V> callable)

Deprecated.

Please use call(java.util.concurrent.Callable)

Invokes the given callable, wrapping any checked exceptions.

call

public static <V> V call(Callable<V> callable,
 Object... extraInfo)

Invokes the given callable, wrapping any checked exceptions.

wrapChecked

@Deprecated
public static <V> V wrapChecked(Callable<V> callable,
 Object... extraInfo)

Deprecated.

Please use call(java.util.concurrent.Callable, java.lang.Object...)

Invokes the given callable, wrapping any checked exceptions.

call

public static <V> V call(Callable<V> callable,
 String message)

Invokes the given callable, wrapping any checked exceptions.

wrapChecked

@Deprecated
public static <V> V wrapChecked(Callable<V> callable,
 String message)

Deprecated.

Please use call(java.util.concurrent.Callable, java.lang.String)

Invokes the given callable, wrapping any checked exceptions.

call

public static <V> V call(Callable<V> callable,
 String message,
 Object... extraInfo)

Invokes the given callable, wrapping any checked exceptions.

wrapChecked

@Deprecated
public static <V> V wrapChecked(Callable<V> callable,
 String message,
 Object... extraInfo)

Deprecated.

Please use call(java.util.concurrent.Callable, java.lang.String, java.lang.Object...)

Invokes the given callable, wrapping any checked exceptions.

callE

public static <V> V callE(CallableE<V,?> callable)

Invokes the given callable, wrapping any checked exceptions.

callE

public static <V> V callE(CallableE<V,?> callable,
 Object... extraInfo)

Invokes the given callable, wrapping any checked exceptions.

callE

public static <V> V callE(CallableE<V,?> callable,
 String message)

Invokes the given callable, wrapping any checked exceptions.

callE

public static <V> V callE(CallableE<V,?> callable,
 String message,
 Object... extraInfo)

Invokes the given callable, wrapping any checked exceptions.

runE

public static void runE(RunnableE<?> runnable)

Invokes the given runnable, wrapping any checked exceptions.

runE

public static void runE(RunnableE<?> runnable,
 Object... extraInfo)

Invokes the given runnable, wrapping any checked exceptions.

runE

public static void runE(RunnableE<?> runnable,
 String message)

Invokes the given runnable, wrapping any checked exceptions.

runE

public static void runE(RunnableE<?> runnable,
 String message,
 Object... extraInfo)

Invokes the given runnable, wrapping any checked exceptions.

getMessage

public String getMessage()

Overrides:

getMessage in class Throwable

getLocalizedMessage

public String getLocalizedMessage()

Overrides:

getLocalizedMessage in class Throwable

getExtraInfo

public Object[] getExtraInfo()

Gets the optional extra info associated with an exception.

Specified by:

getExtraInfo in interface ExtraInfo

Returns:

No defensive copy