4116N/A * Copyright (c) 1994, 2011, Oracle and/or its affiliates. All rights reserved. 0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 0N/A * This code is free software; you can redistribute it and/or modify it 0N/A * under the terms of the GNU General Public License version 2 only, as 2362N/A * published by the Free Software Foundation. Oracle designates this 0N/A * particular file as subject to the "Classpath" exception as provided 2362N/A * by Oracle in the LICENSE file that accompanied this code. 0N/A * This code is distributed in the hope that it will be useful, but WITHOUT 0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 0N/A * version 2 for more details (a copy is included in the LICENSE file that 0N/A * accompanied this code). 0N/A * You should have received a copy of the GNU General Public License version 0N/A * 2 along with this work; if not, write to the Free Software Foundation, 0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 2362N/A * or visit www.oracle.com if you need additional information or have any 2081N/A * The class {@code Exception} and its subclasses are a form of 2081N/A * {@code Throwable} that indicates conditions that a reasonable 0N/A * application might want to catch. 2081N/A * <p>The class {@code Exception} and any subclasses that are not also 2081N/A * subclasses of {@link RuntimeException} are <em>checked 2081N/A * exceptions</em>. Checked exceptions need to be declared in a 2081N/A * method or constructor's {@code throws} clause if they can be thrown 2081N/A * by the execution of the method or constructor and propagate outside 2081N/A * the method or constructor boundary. 0N/A * @author Frank Yellin 0N/A * @see java.lang.Error 4008N/A * @jls 11.2 Compile-Time Checking of Exceptions 2081N/A * Constructs a new exception with {@code null} as its detail message. 0N/A * The cause is not initialized, and may subsequently be initialized by a 0N/A * call to {@link #initCause}. 0N/A * Constructs a new exception with the specified detail message. The 0N/A * cause is not initialized, and may subsequently be initialized by 0N/A * a call to {@link #initCause}. 0N/A * @param message the detail message. The detail message is saved for 0N/A * later retrieval by the {@link #getMessage()} method. 0N/A * Constructs a new exception with the specified detail message and 0N/A * cause. <p>Note that the detail message associated with 2081N/A * {@code cause} is <i>not</i> automatically incorporated in 0N/A * this exception's detail message. 0N/A * @param message the detail message (which is saved for later retrieval 0N/A * by the {@link #getMessage()} method). 0N/A * @param cause the cause (which is saved for later retrieval by the 0N/A * {@link #getCause()} method). (A <tt>null</tt> value is 0N/A * permitted, and indicates that the cause is nonexistent or 0N/A * Constructs a new exception with the specified cause and a detail 0N/A * message of <tt>(cause==null ? null : cause.toString())</tt> (which 0N/A * typically contains the class and detail message of <tt>cause</tt>). 0N/A * This constructor is useful for exceptions that are little more than 0N/A * wrappers for other throwables (for example, {@link 0N/A * java.security.PrivilegedActionException}). 0N/A * @param cause the cause (which is saved for later retrieval by the 0N/A * {@link #getCause()} method). (A <tt>null</tt> value is 0N/A * permitted, and indicates that the cause is nonexistent or 4116N/A * Constructs a new exception with the specified detail message, 4116N/A * cause, suppression enabled or disabled, and writable stack 4116N/A * trace enabled or disabled. 4116N/A * @param message the detail message. 4116N/A * @param cause the cause. (A {@code null} value is permitted, 4116N/A * and indicates that the cause is nonexistent or unknown.) 4116N/A * @param enableSuppression whether or not suppression is enabled 4116N/A * @param writableStackTrace whether or not the stack trace should