30 * Convenience class for reading character files. The constructors of this |
30 * Convenience class for reading character files. The constructors of this |
31 * class assume that the default character encoding and the default byte-buffer |
31 * class assume that the default character encoding and the default byte-buffer |
32 * size are appropriate. To specify these values yourself, construct an |
32 * size are appropriate. To specify these values yourself, construct an |
33 * InputStreamReader on a FileInputStream. |
33 * InputStreamReader on a FileInputStream. |
34 * |
34 * |
35 * <p><code>FileReader</code> is meant for reading streams of characters. |
35 * <p>{@code FileReader} is meant for reading streams of characters. |
36 * For reading streams of raw bytes, consider using a |
36 * For reading streams of raw bytes, consider using a |
37 * <code>FileInputStream</code>. |
37 * {@code FileInputStream}. |
38 * |
38 * |
39 * @see InputStreamReader |
39 * @see InputStreamReader |
40 * @see FileInputStream |
40 * @see FileInputStream |
41 * |
41 * |
42 * @author Mark Reinhold |
42 * @author Mark Reinhold |
43 * @since 1.1 |
43 * @since 1.1 |
44 */ |
44 */ |
45 public class FileReader extends InputStreamReader { |
45 public class FileReader extends InputStreamReader { |
46 |
46 |
47 /** |
47 /** |
48 * Creates a new <tt>FileReader</tt>, given the name of the |
48 * Creates a new {@code FileReader}, given the name of the |
49 * file to read from. |
49 * file to read from. |
50 * |
50 * |
51 * @param fileName the name of the file to read from |
51 * @param fileName the name of the file to read from |
52 * @exception FileNotFoundException if the named file does not exist, |
52 * @exception FileNotFoundException if the named file does not exist, |
53 * is a directory rather than a regular file, |
53 * is a directory rather than a regular file, |
57 public FileReader(String fileName) throws FileNotFoundException { |
57 public FileReader(String fileName) throws FileNotFoundException { |
58 super(new FileInputStream(fileName)); |
58 super(new FileInputStream(fileName)); |
59 } |
59 } |
60 |
60 |
61 /** |
61 /** |
62 * Creates a new <tt>FileReader</tt>, given the <tt>File</tt> |
62 * Creates a new {@code FileReader}, given the {@code File} |
63 * to read from. |
63 * to read from. |
64 * |
64 * |
65 * @param file the <tt>File</tt> to read from |
65 * @param file the {@code File} to read from |
66 * @exception FileNotFoundException if the file does not exist, |
66 * @exception FileNotFoundException if the file does not exist, |
67 * is a directory rather than a regular file, |
67 * is a directory rather than a regular file, |
68 * or for some other reason cannot be opened for |
68 * or for some other reason cannot be opened for |
69 * reading. |
69 * reading. |
70 */ |
70 */ |
71 public FileReader(File file) throws FileNotFoundException { |
71 public FileReader(File file) throws FileNotFoundException { |
72 super(new FileInputStream(file)); |
72 super(new FileInputStream(file)); |
73 } |
73 } |
74 |
74 |
75 /** |
75 /** |
76 * Creates a new <tt>FileReader</tt>, given the |
76 * Creates a new {@code FileReader}, given the |
77 * <tt>FileDescriptor</tt> to read from. |
77 * {@code FileDescriptor} to read from. |
78 * |
78 * |
79 * @param fd the FileDescriptor to read from |
79 * @param fd the FileDescriptor to read from |
80 */ |
80 */ |
81 public FileReader(FileDescriptor fd) { |
81 public FileReader(FileDescriptor fd) { |
82 super(new FileInputStream(fd)); |
82 super(new FileInputStream(fd)); |