gnu.mapping

Class WrappedException

Known Direct Subclasses:
WrongType

public class WrappedException
extends RuntimeException

Encapsulate some Exception inside a RuntimeException. Inspired by org.xml.sax.SAXException written by David Megginson.

Constructor Summary

WrappedException()
Create a new WrappedException.
WrappedException(String message)
Create a new WrappedException.
WrappedException(String message, Throwable e)
Create a new WrappedException from an existing exception.
WrappedException(Throwable e)
Create a new WrappedException wrapping an existing exception.

Method Summary

Throwable
getException()
Return the embedded exception, if any.
String
toString()
Convert this exception to a string.
static RuntimeException
wrapIfNeeded(Throwable ex)
Coerce argument to a RuntimeException.

Constructor Details

WrappedException

public WrappedException()
Create a new WrappedException.

WrappedException

public WrappedException(String message)
Create a new WrappedException.
Parameters:
message - The error or warning message.

WrappedException

public WrappedException(String message,
                        Throwable e)
Create a new WrappedException from an existing exception.

The existing exception will be embedded in the new one, but the new exception will have its own message.

Parameters:
message - The detail message.
e - The exception to be wrapped in a WrappedException.

WrappedException

public WrappedException(Throwable e)
Create a new WrappedException wrapping an existing exception.

The existing exception will be embedded in the new one, and its message will become the default message for the WrappedException.

Parameters:
e - The exception to be wrapped in a WrappedException.

Method Details

getException

public Throwable getException()
Return the embedded exception, if any.
Returns:
The embedded exception, or null if there is none.

toString

public String toString()
Convert this exception to a string.
Returns:
A string version of this exception.

wrapIfNeeded

public static RuntimeException wrapIfNeeded(Throwable ex)
Coerce argument to a RuntimeException.