java.lang.reflect
Class UndeclaredThrowableException
java.lang.Object
|
+--java.lang.Throwable
|
+--java.lang.Exception
|
+--java.lang.RuntimeException
|
+--java.lang.reflect.UndeclaredThrowableException
- All Implemented Interfaces:
- java.io.Serializable
- public class UndeclaredThrowableException
- extends java.lang.RuntimeException
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.
As of release 1.4, this exception has been retrofitted to conform to
the general purpose exception-chaining mechanism. The "undeclared checked
exception that was thrown by the invocation handler" that may be provided
at construction time and accessed via the #getException()
method
is now known as the cause, and may be accessed via the
Throwable#getCause()
method, as well as the aforementioned "legacy
method."
- Since:
- JDK1.3
- See Also:
InvocationHandler
, Serialized Form
Constructor Summary |
UndeclaredThrowableException(java.lang.Throwable undeclaredThrowable)
Constructs an UndeclaredThrowableException with the
specified Throwable . |
UndeclaredThrowableException(java.lang.Throwable undeclaredThrowable,
java.lang.String s)
Constructs an UndeclaredThrowableException with the
specified Throwable and a detail message. |
Method Summary |
java.lang.Throwable |
getCause()
Returns the the cause of this exception (the Throwable
instance wrapped in this UndeclaredThrowableException ,
which may be null). |
java.lang.Throwable |
getUndeclaredThrowable()
Returns the Throwable instance wrapped in this
UndeclaredThrowableException , which may be null. |
Methods inherited from class java.lang.Throwable |
fillInStackTrace, getLocalizedMessage, getMessage, printStackTrace, printStackTrace, printStackTrace, toString |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
UndeclaredThrowableException
public UndeclaredThrowableException(java.lang.Throwable undeclaredThrowable)
- Constructs an
UndeclaredThrowableException
with the
specified Throwable
.
- Parameters:
undeclaredThrowable
- the undeclared checked exception
that was thrown
UndeclaredThrowableException
public UndeclaredThrowableException(java.lang.Throwable undeclaredThrowable,
java.lang.String s)
- Constructs an
UndeclaredThrowableException
with the
specified Throwable
and a detail message.
- Parameters:
undeclaredThrowable
- the undeclared checked exception
that was throwns
- the detail message
getUndeclaredThrowable
public java.lang.Throwable getUndeclaredThrowable()
- Returns the
Throwable
instance wrapped in this
UndeclaredThrowableException
, which may be null.
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
getCause
public java.lang.Throwable getCause()
- Returns the the cause of this exception (the
Throwable
instance wrapped in this UndeclaredThrowableException
,
which may be null).
- Returns:
- the cause of this exception.
- Since:
- 1.4