Source for java.lang.reflect.InvocationTargetException

 1:  /* InvocationTargetException.java -- Wrapper exception for reflection
 2:  Copyright (C) 1998, 1999, 2000, 2001, 2002, 2005 Free Software Foundation, Inc.
 3: 
 4: This file is part of GNU Classpath.
 5: 
 6: GNU Classpath is free software; you can redistribute it and/or modify
 7: it under the terms of the GNU General Public License as published by
 8: the Free Software Foundation; either version 2, or (at your option)
 9: any later version.
 10: 
 11: GNU Classpath is distributed in the hope that it will be useful, but
 12: WITHOUT ANY WARRANTY; without even the implied warranty of
 13: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 14: General Public License for more details.
 15: 
 16: You should have received a copy of the GNU General Public License
 17: along with GNU Classpath; see the file COPYING. If not, write to the
 18: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
 19: 02110-1301 USA.
 20: 
 21: Linking this library statically or dynamically with other modules is
 22: making a combined work based on this library. Thus, the terms and
 23: conditions of the GNU General Public License cover the whole
 24: combination.
 25: 
 26: As a special exception, the copyright holders of this library give you
 27: permission to link this library with independent modules to produce an
 28: executable, regardless of the license terms of these independent
 29: modules, and to copy and distribute the resulting executable under
 30: terms of your choice, provided that you also meet, for each linked
 31: independent module, the terms and conditions of the license of that
 32: module. An independent module is a module which is not derived from
 33: or based on this library. If you modify this library, you may extend
 34: this exception to your version of the library, but you are not
 35: obligated to do so. If you do not wish to do so, delete this
 36: exception statement from your version. */
 37: 
 38: 
 39:  package java.lang.reflect;
 40: 
 41:  /**
 42:  * InvocationTargetException is sort of a way to "wrap" whatever exception
 43:  * comes up when a method or constructor is called via Reflection. As of
 44:  * JDK 1.4, it was retrofitted to match the exception chaining of all other
 45:  * exceptions, but <code>getTargetException()</code> still works.
 46:  *
 47:  * @author John Keiser
 48:  * @author Tom Tromey (tromey@cygnus.com)
 49:  * @author Eric Blake (ebb9@email.byu.edu)
 50:  * @see Method#invoke(Object,Object[])
 51:  * @see Constructor#newInstance(Object[])
 52:  * @since 1.1
 53:  * @status updated to 1.4
 54:  */
 55:  public class InvocationTargetException extends Exception
 56: {
 57:  /**
 58:  * Compatible with JDK 1.1+.
 59:  */
 60:  private static final long serialVersionUID = 4085088731926701167L;
 61: 
 62:  /**
 63:  * The chained exception. This field is only around for serial compatibility.
 64:  *
 65:  * @serial the chained exception
 66:  */
 67:  private final Throwable target;
 68: 
 69:  /**
 70:  * Construct an exception with null as the cause. The cause is initialized
 71:  * to null.
 72:  */
 73:  protected InvocationTargetException()
 74:  {
 75:  this(null, null);
 76:  }
 77: 
 78:  /**
 79:  * Create an <code>InvocationTargetException</code> using another
 80:  * exception.
 81:  *
 82:  * @param targetException the exception to wrap
 83:  */
 84:  public InvocationTargetException(Throwable targetException)
 85:  {
 86:  this(targetException, null);
 87:  }
 88: 
 89:  /**
 90:  * Create an <code>InvocationTargetException</code> using another
 91:  * exception and an error message.
 92:  *
 93:  * @param targetException the exception to wrap
 94:  * @param err an extra reason for the exception-throwing
 95:  */
 96:  public InvocationTargetException(Throwable targetException, String err)
 97:  {
 98:  super(err, targetException);
 99:  target = targetException;
 100:  }
 101: 
 102:  /**
 103:  * Get the wrapped (targeted) exception.
 104:  *
 105:  * @return the targeted exception
 106:  * @see #getCause()
 107:  */
 108:  public Throwable getTargetException()
 109:  {
 110:  return target;
 111:  }
 112: 
 113:  /**
 114:  * Returns the cause of this exception (which may be null).
 115:  *
 116:  * @return the cause
 117:  * @since 1.4
 118:  */
 119:  public Throwable getCause()
 120:  {
 121:  return target;
 122:  }
 123: }