java.lang.ClassNotFoundException Maven / Gradle / Ivy

/*
This is not an official specification document, and usage is restricted.


NOTICE





(c) 2005-2007 Sun Microsystems, Inc. All Rights Reserved.

Neither this file nor any files generated from it describe a complete
specification, and they may only be used as described below. For
example, no permission is given for you to incorporate this file, in
whole or in part, in an implementation of a Java specification.

Sun Microsystems Inc. owns the copyright in this file and it is provided
to you for informative, as opposed to normative, use. The file and any
files generated from it may be used to generate other informative
documentation, such as a unified set of documents of API signatures for
a platform that includes technologies expressed as Java APIs. The file
may also be used to produce "compilation stubs," which allow
applications to be compiled and validated for such platforms.

Any work generated from this file, such as unified javadocs or compiled
stub files, must be accompanied by this notice in its entirety.

This work corresponds to the API signatures of JSR 219: Foundation
Profile 1.1. In the event of a discrepency between this work and the
JSR 219 specification, which is available at
http://www.jcp.org/en/jsr/detail?id=219, the latter takes precedence.
*/


  


package java.lang;

/** 
 * Thrown when an application tries to load in a class through its 
 * string name using:
 * 

 * The forName method in class Class.
 * 
The findSystemClass method in class
 *     ClassLoader .
 * 
The loadClass method in class ClassLoader.
 * 
 * 
 * but no definition for the class with the specified name could be found. 
 *
 * 
As of release 1.4, this exception has been retrofitted to conform to
 * the general purpose exception-chaining mechanism.  The "optional exception
 * that was raised while loading the class" that may be provided at
 * construction time and accessed via the {@link #getException()} method is
 * now known as the cause, and may be accessed via the {@link
 * Throwable#getCause()} method, as well as the aforementioned "legacy method."
 *
 * @author  unascribed
 * @version 1.13, 02/02/00
 * @see     java.lang.Class#forName(java.lang.String)
 * @see     java.lang.ClassLoader#findSystemClass(java.lang.String)
 * @see     java.lang.ClassLoader#loadClass(java.lang.String, boolean)
 * @since   JDK1.0
 */
public class ClassNotFoundException extends java.lang.Exception
{
    /**
     * use serialVersionUID from JDK 1.1.X for interoperability
     */
     private static final long serialVersionUID = 9176873029745254542L;
    
    /** 
     * This field holds the exception ex if the 
     * ClassNotFoundException(String s, Throwable ex) constructor was
     * used to instantiate the object
     * @serial 
     * @since 1.2
     */
    private java.lang.Throwable ex;

    /** 
     * Constructs a ClassNotFoundException with no detail message.
     */
    public ClassNotFoundException() { }

    /** 
     * Constructs a ClassNotFoundException with the 
     * specified detail message. 
     *
     * @param   s   the detail message.
     */
    public ClassNotFoundException(java.lang.String s) { }

    /** 
     * Constructs a ClassNotFoundException with the
     * specified detail message and optional exception that was
     * raised while loading the class.
     *
     * @param s the detail message
     * @param ex the exception that was raised while loading the class
     * @since 1.2
     */
    public ClassNotFoundException(java.lang.String s, java.lang.Throwable ex)
    { }

    /** 
     * Returns the exception that was raised if an error occurred while
     * attempting to load the class. Otherwise, returns null.
     *
     * This method predates the general-purpose exception chaining facility.
     * The {@link Throwable#getCause()} method is now the preferred means of
     * obtaining this information.
     *
     * @return the Exception that was raised while loading a class
     * @since 1.2
     */
    public java.lang.Throwable getException() {
        return null;
    }

    /** 
     * Returns the the cause of this exception (the exception that was raised
     * if an error occurred while attempting to load the class; otherwise
     * null).
     *
     * @return  the cause of this exception.
     * @since   1.4
     */
    public java.lang.Throwable getCause() {
        return null;
    }
}