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: }
|