java.lang.reflect
Class UndeclaredThrowableException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by java.lang.reflect.UndeclaredThrowableException
All Implemented Interfaces:
Serializable

public class UndeclaredThrowableException
extends RuntimeException

This exception class is thrown by a Proxy instance if the invoke method of that instance's InvocationHandler attempts to throw an exception that not declared by the throws clauses of all of the interface methods that the proxy instance is implementing.

When thrown by Proxy, this class will always wrap a checked exception, never Error or RuntimeException, which are unchecked.

Since:
1.3
See Also:
Proxy, InvocationHandler, Serialized Form

Constructor Summary
UndeclaredThrowableException(Throwable cause)
          Wraps the given checked exception into a RuntimeException, with no detail message.
UndeclaredThrowableException(Throwable cause, String message)
          Wraps the given checked exception into a RuntimeException, with the specified detail message.
 
Method Summary
 Throwable getCause()
          Returns the cause of this exception.
 Throwable getUndeclaredThrowable()
          Returns the cause of this exception.
 
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

UndeclaredThrowableException

public UndeclaredThrowableException(Throwable cause)
Wraps the given checked exception into a RuntimeException, with no detail message. Throwable.initCause(Throwable) will fail on this instance.

Parameters:
cause - the undeclared throwable that caused this exception, may be null

UndeclaredThrowableException

public UndeclaredThrowableException(Throwable cause,
                                    String message)
Wraps the given checked exception into a RuntimeException, with the specified detail message. Throwable.initCause(Throwable) will fail on this instance.

Parameters:
cause - the undeclared throwable that caused this exception, may be null
message - the message, may be null
Method Detail

getUndeclaredThrowable

public Throwable getUndeclaredThrowable()
Returns the cause of this exception. If this exception was created by a Proxy instance, it will be a non-null checked exception. This method pre-dates exception chaining, and is now simply a longer way to call getCause().

Returns:
the cause of this exception, may be null
See Also:
getCause()

getCause

public Throwable getCause()
Returns the cause of this exception. If this exception was created by a Proxy instance, it will be a non-null checked exception.

Overrides:
getCause in class Throwable
Returns:
the cause of this exception, may be null
Since:
1.4