01 /*
02 * Copyright 1994-1999 Sun Microsystems, Inc. All Rights Reserved.
03 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
04 *
05 * This code is free software; you can redistribute it and/or modify it
06 * under the terms of the GNU General Public License version 2 only, as
07 * published by the Free Software Foundation. Sun designates this
08 * particular file as subject to the "Classpath" exception as provided
09 * by Sun in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
22 * CA 95054 USA or visit www.sun.com if you need additional information or
23 * have any questions.
24 */
25
26 package java.io;
27
28 /**
29 * Signals that an attempt to open the file denoted by a specified pathname
30 * has failed.
31 *
32 * <p> This exception will be thrown by the {@link FileInputStream}, {@link
33 * FileOutputStream}, and {@link RandomAccessFile} constructors when a file
34 * with the specified pathname does not exist. It will also be thrown by these
35 * constructors if the file does exist but for some reason is inaccessible, for
36 * example when an attempt is made to open a read-only file for writing.
37 *
38 * @author unascribed
39 * @version 1.30, 05/05/07
40 * @since JDK1.0
41 */
42
43 public class FileNotFoundException extends IOException {
44
45 /**
46 * Constructs a <code>FileNotFoundException</code> with
47 * <code>null</code> as its error detail message.
48 */
49 public FileNotFoundException() {
50 super ();
51 }
52
53 /**
54 * Constructs a <code>FileNotFoundException</code> with the
55 * specified detail message. The string <code>s</code> can be
56 * retrieved later by the
57 * <code>{@link java.lang.Throwable#getMessage}</code>
58 * method of class <code>java.lang.Throwable</code>.
59 *
60 * @param s the detail message.
61 */
62 public FileNotFoundException(String s) {
63 super (s);
64 }
65
66 /**
67 * Constructs a <code>FileNotFoundException</code> with a detail message
68 * consisting of the given pathname string followed by the given reason
69 * string. If the <code>reason</code> argument is <code>null</code> then
70 * it will be omitted. This private constructor is invoked only by native
71 * I/O methods.
72 *
73 * @since 1.2
74 */
75 private FileNotFoundException(String path, String reason) {
76 super (path + ((reason == null) ? "" : " (" + reason + ")"));
77 }
78
79 }
|