FileDocCategorySizeDatePackage
ClassNotFoundException.javaAPI DocJava SE 5 API3528Fri Aug 26 14:57:02 BST 2005java.lang

ClassNotFoundException

public class ClassNotFoundException extends Exception
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.20, 02/19/04
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

Fields Summary
private static final long
serialVersionUID
use serialVersionUID from JDK 1.1.X for interoperability
private Throwable
ex
This field holds the exception ex if the ClassNotFoundException(String s, Throwable ex) constructor was used to instantiate the object
Constructors Summary
public ClassNotFoundException()
Constructs a ClassNotFoundException with no detail message.


                
      
	super((Throwable)null);  // Disallow initCause
    
public ClassNotFoundException(String s)
Constructs a ClassNotFoundException with the specified detail message.

param
s the detail message.

	super(s, null);  //  Disallow initCause
    
public ClassNotFoundException(String s, Throwable ex)
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

	super(s, null);  //  Disallow initCause
	this.ex = ex;
    
Methods Summary
public java.lang.ThrowablegetCause()
Returns 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

        return ex;
    
public java.lang.ThrowablegetException()
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

        return ex;