package java.lang;

import ej.annotation.Nullable;

/**
 * Thrown when an application tries to load in a class through its string name using:
 * <ul>
 * <li>The <code>forName</code> method in class <code>Class</code>.
 * <li>The <code>findSystemClass</code> method in class <code>ClassLoader</code> .
 * <li>The <code>loadClass</code> method in class <code>ClassLoader</code>.
 * </ul>
 * <p>
 * but no definition for the class with the specified name could be found.
 *
 * <p>
 * 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 <i>cause</i>, and may be accessed via the {@link Throwable#getCause()} method,
 * as well as the aforementioned "legacy method."
 *
 * @see java.lang.Class#forName(java.lang.String)
 */
public class ClassNotFoundException extends ReflectiveOperationException {

    /**
     * Constructs a <code>ClassNotFoundException</code> with no detail message.
     */
    public ClassNotFoundException() {
        throw new RuntimeException();
    }

    /**
     * Constructs a <code>ClassNotFoundException</code> with the specified detail message.
     *
     * @param s
     *        the detail message.
     */
    public ClassNotFoundException(String s) {
        throw new RuntimeException();
    }

    /**
     * Constructs a <code>ClassNotFoundException</code> 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
     */
    public ClassNotFoundException(String s, Throwable ex) {
        throw new RuntimeException();
    }

    /**
     * Returns the cause of this exception (the exception that was raised if an error occurred while
     * attempting to load the class; otherwise <code>null</code>).
     *
     * @return the cause of this exception.
     */
    @Override
    @Nullable
    public Throwable getCause() {
        throw new RuntimeException();
    }

    /**
     * Returns the exception that was raised if an error occurred while attempting to load the class.
     * Otherwise, returns <code>null</code>.
     *
     * <p>
     * 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 <code>Exception</code> that was raised while loading a class
     */
    @Nullable
    public Throwable getException() {
        throw new RuntimeException();
    }
}