zkoss/zk

/* FileReader.java

    Purpose:
        
    Description:
        
    History:
        Tue Aug 19 15:01:16     2008, Created by tomyeh

Copyright (C) 2008 Potix Corporation. All Rights Reserved.

{{IS_RIGHT
    This program is distributed under LGPL Version 2.1 in the hope that
    it will be useful, but WITHOUT ANY WARRANTY.
}}IS_RIGHT
*/
package org.zkoss.io;

import java.io.File;
import java.io.FileInputStream;
import java.io.InputStreamReader;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.FileDescriptor;

/**
 * Convenience class for reading character files.
 * Unlike java.io.FileReader, where the default character encoding is used,
 * it accepts different character encoding.
 *
 * @author tomyeh
 * @since 3.0.8
 */
public class FileReader extends InputStreamReader {
   /**
    * Creates a new FileReader, given the name of the file to read from.
    *
    * @param filename the name of the file to read from
    * @param charset the charset to decode the file, such as UTF-8.
    * If null, UTF-8 is assumed.
    * @exception FileNotFoundException  if the named file does not exist,
    * is a directory rather than a regular file,
    * or for some other reason cannot be opened for reading.
    */
    public FileReader(String filename, String charset)
    throws IOException {
        super(new FileInputStream(filename), charset != null ? charset: "UTF-8");
    }

   /**
    * Creates a new FileReader, given the File instance to read from.
    *
    * @param file the File to read from
    * @param charset the charset to decode the file, such as UTF-8.
    * If null, UTF-8 is assumed.
    * @exception FileNotFoundException  if the named file does not exist,
    * is a directory rather than a regular file,
    * or for some other reason cannot be opened for reading.
    */
    public FileReader(File file, String charset) throws IOException {
        super(new FileInputStream(file), charset != null ? charset: "UTF-8");
    }

   /**
    * Creates a new FileReader, given the 
    * FileDescriptor to read from.
    *
    * @param fd the FileDescriptor to read from
    * @param charset the charset to decode the file, such as UTF-8.
    * If null, UTF-8 is assumed.
    */
    public FileReader(FileDescriptor fd, String charset)
    throws IOException {
        super(new FileInputStream(fd), charset != null ? charset: "UTF-8");
    }
}