Class UndeclaredThrowableException
java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
java.lang.reflect.UndeclaredThrowableException
- All Implemented Interfaces:
Serializable
Thrown by a method invocation on a proxy instance if its invocation
handler's
invoke
method throws a
checked exception (a Throwable
that is not assignable
to RuntimeException
or Error
) that
is not assignable to any of the exception types declared in the
throws
clause of the method that was invoked on the
proxy instance and dispatched to the invocation handler.
An UndeclaredThrowableException
instance contains
the undeclared checked exception that was thrown by the invocation
handler, and it can be retrieved with the
getUndeclaredThrowable()
method.
UndeclaredThrowableException
extends
RuntimeException
, so it is an unchecked exception
that wraps a checked exception.
- Since:
- 1.3
- See Also:
-
Constructor Summary
ConstructorDescriptionUndeclaredThrowableException
(Throwable undeclaredThrowable) Constructs anUndeclaredThrowableException
with the specifiedThrowable
.UndeclaredThrowableException
(Throwable undeclaredThrowable, String s) Constructs anUndeclaredThrowableException
with the specifiedThrowable
and a detail message. -
Method Summary
Modifier and TypeMethodDescriptionReturns theThrowable
instance wrapped in thisUndeclaredThrowableException
, which may benull
.Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
Constructor Details
-
UndeclaredThrowableException
Constructs anUndeclaredThrowableException
with the specifiedThrowable
.- Parameters:
undeclaredThrowable
- the undeclared checked exception that was thrown
-
UndeclaredThrowableException
-
-
Method Details
-
getUndeclaredThrowable
Returns theThrowable
instance wrapped in thisUndeclaredThrowableException
, which may benull
.- API Note:
- This method predates the general-purpose exception chaining facility.
The
Throwable.getCause()
method is now the preferred means of obtaining this information. - Returns:
- the undeclared checked exception that was thrown
-