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

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
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 Detail

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 Detail

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.