|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.lang.Throwable java.lang.Exception java.lang.RuntimeException java.lang.reflect.UndeclaredThrowableException
public class UndeclaredThrowableException
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 getUndeclaredThrowable()
method is now known as the
cause, and may be accessed via the Throwable.getCause()
method, as well as the aforementioned "legacy
method."
InvocationHandler
,
Serialized FormConstructor Summary | |
---|---|
UndeclaredThrowableException(Throwable undeclaredThrowable)
Constructs an UndeclaredThrowableException with the
specified Throwable . |
|
UndeclaredThrowableException(Throwable undeclaredThrowable,
String s)
Constructs an UndeclaredThrowableException with the
specified Throwable and a detail message. |
Method Summary | |
---|---|
Throwable |
getCause()
Returns the cause of this exception (the Throwable
instance wrapped in this UndeclaredThrowableException ,
which may be null). |
Throwable |
getUndeclaredThrowable()
Returns the Throwable instance wrapped in this
UndeclaredThrowableException , which may be null. |
Methods inherited from class java.lang.Throwable |
---|
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, 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 |
---|
public UndeclaredThrowableException(Throwable undeclaredThrowable)
UndeclaredThrowableException
with the
specified Throwable
.
undeclaredThrowable
- the undeclared checked exception
that was thrownpublic UndeclaredThrowableException(Throwable undeclaredThrowable, String s)
UndeclaredThrowableException
with the
specified Throwable
and a detail message.
undeclaredThrowable
- the undeclared checked exception
that was throwns
- the detail messageMethod Detail |
---|
public Throwable getUndeclaredThrowable()
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.
public Throwable getCause()
Throwable
instance wrapped in this UndeclaredThrowableException
,
which may be null).
getCause
in class Throwable
|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1993, 2010, Oracle and/or its affiliates. All rights reserved.