Class UndeclaredThrowableException
- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- java.lang.RuntimeException
-
- java.lang.reflect.UndeclaredThrowableException
-
- All Implemented Interfaces:
- Serializable
public class UndeclaredThrowableException extends RuntimeException
Thrown by a method invocation on a proxy instance if its invocation handler'sinvokemethod throws a checked exception (aThrowablethat is not assignable toRuntimeExceptionorError) that is not assignable to any of the exception types declared in thethrowsclause of the method that was invoked on the proxy instance and dispatched to the invocation handler.An
UndeclaredThrowableExceptioninstance contains the undeclared checked exception that was thrown by the invocation handler, and it can be retrieved with thegetUndeclaredThrowable()method.UndeclaredThrowableExceptionextendsRuntimeException, 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 theThrowable.getCause()method, as well as the aforementioned "legacy method."- Since:
- 1.3
- See Also:
-
InvocationHandler, Serialized Form
-
-
Constructor Summary
Constructors Constructor and Description UndeclaredThrowableException(Throwable undeclaredThrowable)Constructs anUndeclaredThrowableExceptionwith the specifiedThrowable.UndeclaredThrowableException(Throwable undeclaredThrowable, String s)Constructs anUndeclaredThrowableExceptionwith the specifiedThrowableand a detail message.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method and Description ThrowablegetCause()Returns the cause of this exception (theThrowableinstance wrapped in thisUndeclaredThrowableException, which may benull).ThrowablegetUndeclaredThrowable()Returns theThrowableinstance wrapped in thisUndeclaredThrowableException, which may benull.-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
-
-
-
Constructor Detail
UndeclaredThrowableException
public UndeclaredThrowableException(Throwable undeclaredThrowable)
Constructs anUndeclaredThrowableExceptionwith the specifiedThrowable.- Parameters:
-
undeclaredThrowable- the undeclared checked exception that was thrown
UndeclaredThrowableException
public UndeclaredThrowableException(Throwable undeclaredThrowable, String s)
Constructs anUndeclaredThrowableExceptionwith the specifiedThrowableand a detail message.- Parameters:
-
undeclaredThrowable- the undeclared checked exception that was thrown -
s- the detail message
-
Method Detail
getUndeclaredThrowable
public Throwable getUndeclaredThrowable()
Returns theThrowableinstance wrapped in thisUndeclaredThrowableException, which may benull.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
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
