java.lang.reflect
Class InvocationTargetException

java.lang.Object sample code for java.lang.Object definition code for java.lang.Object 
  extended by java.lang.Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable 
      extended by java.lang.Exception sample code for java.lang.Exception definition code for java.lang.Exception 
          extended by java.lang.reflect.InvocationTargetException
All Implemented Interfaces:
Serializable sample code for java.io.Serializable definition code for java.io.Serializable

public class InvocationTargetException
extends Exception sample code for java.lang.Exception definition code for java.lang.Exception

InvocationTargetException is a checked exception that wraps an exception thrown by an invoked method or constructor.

As of release 1.4, this exception has been retrofitted to conform to the general purpose exception-chaining mechanism. The "target exception" that is provided at construction time and accessed via the getTargetException() sample code for java.lang.reflect.InvocationTargetException.getTargetException() definition code for java.lang.reflect.InvocationTargetException.getTargetException() method is now known as the cause, and may be accessed via the Throwable.getCause() sample code for java.lang.Throwable.getCause() definition code for java.lang.Throwable.getCause() method, as well as the aforementioned "legacy method."

See Also:
Method sample code for java.lang.reflect.Method definition code for java.lang.reflect.Method , Constructor sample code for java.lang.reflect.Constructor definition code for java.lang.reflect.Constructor , Serialized Form

Constructor Summary
protected InvocationTargetException sample code for java.lang.reflect.InvocationTargetException.InvocationTargetException() definition code for java.lang.reflect.InvocationTargetException.InvocationTargetException() ()
          Constructs an InvocationTargetException with null as the target exception.
  InvocationTargetException sample code for java.lang.reflect.InvocationTargetException.InvocationTargetException(java.lang.Throwable) definition code for java.lang.reflect.InvocationTargetException.InvocationTargetException(java.lang.Throwable) (Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable  target)
          Constructs a InvocationTargetException with a target exception.
  InvocationTargetException sample code for java.lang.reflect.InvocationTargetException.InvocationTargetException(java.lang.Throwable, java.lang.String) definition code for java.lang.reflect.InvocationTargetException.InvocationTargetException(java.lang.Throwable, java.lang.String) (Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable  target, String sample code for java.lang.String definition code for java.lang.String  s)
          Constructs a InvocationTargetException with a target exception and a detail message.
 
Method Summary
 Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable getCause sample code for java.lang.reflect.InvocationTargetException.getCause() definition code for java.lang.reflect.InvocationTargetException.getCause() ()
          Returns the cause of this exception (the thrown target exception, which may be null).
 Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable getTargetException sample code for java.lang.reflect.InvocationTargetException.getTargetException() definition code for java.lang.reflect.InvocationTargetException.getTargetException() ()
          Get the thrown target exception.
 
Methods inherited from class java.lang.Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable
fillInStackTrace sample code for java.lang.Throwable.fillInStackTrace() definition code for java.lang.Throwable.fillInStackTrace() , getLocalizedMessage sample code for java.lang.Throwable.getLocalizedMessage() definition code for java.lang.Throwable.getLocalizedMessage() , getMessage sample code for java.lang.Throwable.getMessage() definition code for java.lang.Throwable.getMessage() , getStackTrace sample code for java.lang.Throwable.getStackTrace() definition code for java.lang.Throwable.getStackTrace() , initCause sample code for java.lang.Throwable.initCause(java.lang.Throwable) definition code for java.lang.Throwable.initCause(java.lang.Throwable) , printStackTrace sample code for java.lang.Throwable.printStackTrace() definition code for java.lang.Throwable.printStackTrace() , printStackTrace sample code for java.lang.Throwable.printStackTrace(java.io.PrintStream) definition code for java.lang.Throwable.printStackTrace(java.io.PrintStream) , printStackTrace sample code for java.lang.Throwable.printStackTrace(java.io.PrintWriter) definition code for java.lang.Throwable.printStackTrace(java.io.PrintWriter) , setStackTrace sample code for java.lang.Throwable.setStackTrace(java.lang.StackTraceElement[]) definition code for java.lang.Throwable.setStackTrace(java.lang.StackTraceElement[]) , toString sample code for java.lang.Throwable.toString() definition code for java.lang.Throwable.toString()
 
Methods inherited from class java.lang.Object sample code for java.lang.Object definition code for java.lang.Object
clone sample code for java.lang.Object.clone() definition code for java.lang.Object.clone() , equals sample code for java.lang.Object.equals(java.lang.Object) definition code for java.lang.Object.equals(java.lang.Object) , finalize sample code for java.lang.Object.finalize() definition code for java.lang.Object.finalize() , getClass sample code for java.lang.Object.getClass() definition code for java.lang.Object.getClass() , hashCode sample code for java.lang.Object.hashCode() definition code for java.lang.Object.hashCode() , notify sample code for java.lang.Object.notify() definition code for java.lang.Object.notify() , notifyAll sample code for java.lang.Object.notifyAll() definition code for java.lang.Object.notifyAll() , wait sample code for java.lang.Object.wait() definition code for java.lang.Object.wait() , wait sample code for java.lang.Object.wait(long) definition code for java.lang.Object.wait(long) , wait sample code for java.lang.Object.wait(long, int) definition code for java.lang.Object.wait(long, int)
 

Constructor Detail

InvocationTargetException sample code for java.lang.reflect.InvocationTargetException() definition code for java.lang.reflect.InvocationTargetException()

protected InvocationTargetException()
Constructs an InvocationTargetException with null as the target exception.


InvocationTargetException sample code for java.lang.reflect.InvocationTargetException(java.lang.Throwable) definition code for java.lang.reflect.InvocationTargetException(java.lang.Throwable)

public InvocationTargetException(Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable  target)
Constructs a InvocationTargetException with a target exception.

Parameters:
target - the target exception

InvocationTargetException sample code for java.lang.reflect.InvocationTargetException(java.lang.Throwable, java.lang.String) definition code for java.lang.reflect.InvocationTargetException(java.lang.Throwable, java.lang.String)

public InvocationTargetException(Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable  target,
                                 String sample code for java.lang.String definition code for java.lang.String  s)
Constructs a InvocationTargetException with a target exception and a detail message.

Parameters:
target - the target exception
s - the detail message
Method Detail

getTargetException sample code for java.lang.reflect.InvocationTargetException.getTargetException() definition code for java.lang.reflect.InvocationTargetException.getTargetException()

public Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable  getTargetException()
Get the thrown target exception.

This method predates the general-purpose exception chaining facility. The Throwable.getCause() sample code for java.lang.Throwable.getCause() definition code for java.lang.Throwable.getCause() method is now the preferred means of obtaining this information.

Returns:
the thrown target exception (cause of this exception).

getCause sample code for java.lang.reflect.InvocationTargetException.getCause() definition code for java.lang.reflect.InvocationTargetException.getCause()

public Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable  getCause()
Returns the cause of this exception (the thrown target exception, which may be null).

Overrides:
getCause sample code for java.lang.Throwable.getCause() definition code for java.lang.Throwable.getCause() in class Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable
Returns:
the cause of this exception.
Since:
1.4