Package gnu.mapping
Class WrappedException
java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
gnu.mapping.WrappedException
- All Implemented Interfaces:
Serializable
- Direct Known Subclasses:
WrongType
Encapsulate some Exception inside a RuntimeException.
Inspired by org.xml.sax.SAXException written by David Megginson.
- See Also:
-
Constructor Summary
ConstructorsConstructorDescriptionCreate a new WrappedException.WrappedException
(String message) Create a new WrappedException.WrappedException
(String message, Throwable e) Create a new WrappedException from an existing exception.Create a new WrappedException wrapping an existing exception. -
Method Summary
Modifier and TypeMethodDescriptionReturn the embedded exception, if any.static RuntimeException
Re-throw as a non-checked exception.toString()
Convert this exception to a string.static RuntimeException
Coerce argument to a RuntimeException.Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace
-
Constructor Details
-
WrappedException
public WrappedException()Create a new WrappedException. -
WrappedException
Create a new WrappedException.- Parameters:
message
- The error or warning message.
-
WrappedException
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.
-
WrappedException
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.
-
-
Method Details
-
getException
Return the embedded exception, if any.- Returns:
- The embedded exception, or null if there is none.
-
toString
Convert this exception to a string. -
wrapIfNeeded
Coerce argument to a RuntimeException. Using rethrow may be preferable as it doesn't require wrapping an Error. -
rethrow
Re-throw as a non-checked exception. This method never returns, in spite of the return type. This allows the call to be written as:throw WrappedExcepton.rethrow(ex)
so javac and the verifier can know the code doesn't return.
-