java.io
Class FileWriter

java.lang.Object
  java.io.Writer
      java.io.OutputStreamWriter
          java.io.FileWriter

public class FileWriter

extends OutputStreamWriter

Convenience class for writing character files. The constructors of this class assume that the default character encoding and the default byte-buffer size are acceptable. To specify these values yourself, construct an OutputStreamWriter on a FileOutputStream. 输出字符文件的工具类。该类的构造函数假定默认的字符编码和默认的字节缓冲大小是合适的。如果自己要指定这些值，应该基于FileOutStream构造一个OutStreamWriter。

Whether or not a file is available or may be created depends upon the underlying platform. Some platforms, in particular, allow a file to be opened for writing by only one FileWriter (or other file-writing object) at a time. In such situations the constructors in this class will fail if the file involved is already open. 文件是否可用或可创建依赖于底层平台。特别地，某些平台只允许FileWriter或者其它文件输出对象打开该文件一次用于输出。在这种情况下如果调用的文件已被打开，类的构造函数将会失败。

FileWriter is meant for writing streams of characters. For writing streams of raw bytes, consider using a FileOutputStream. FileWriter是读取字符流的工具。如果输出字节流，应该考虑采用FileOutputStream。

Since:

JDK1.1

See Also:

OutputStreamWriter, FileOutputStream

Field Summary

 

Fields inherited from class java.io.Writer

lock

 

Constructor Summary

FileWriter(File file)           Constructs a FileWriter object given a File object. 构建一个给定File对象的FileWriter对象。

FileWriter(File file, boolean append)           Constructs a FileWriter object given a File object. 构建一个给定File对象的FileWriter对象。

FileWriter(FileDescriptor fd)           Constructs a FileWriter object associated with a file descriptor. 构建一个与文件描述符关联的FileWriter对象。

FileWriter(String fileName)           Constructs a FileWriter object given a file name. 构建一个给定文件名的FileWriter对象。

FileWriter(String fileName, boolean append)           Constructs a FileWriter object given a file name with a boolean indicating whether or not to append the data written. 构建一个给定文件名的FileWriter对象，使用布尔值标识是否附加写入的数据。

 

Methods inherited from class java.io.OutputStreamWriter

close, flush, getEncoding, write, write, write

 

Methods inherited from class java.io.Writer

write, write

 

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

Constructor Detail

FileWriter

public FileWriter(String fileName)
           throws IOException

Constructs a FileWriter object given a file name. 构建一个给定文件名的FileWriter对象。

Parameters:

fileName - String The system-dependent filename. 字符串，系统相关的文件名。

Throws:

IOException - if the named file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot be opened for any other reason 如果该名称的文件存在但是是目录而不是常规文件，或者不存在但不能被创建， 或者其他原因不能打开，则抛出

FileWriter

public FileWriter(String fileName,
                  boolean append)
           throws IOException

Constructs a FileWriter object given a file name with a boolean indicating whether or not to append the data written. 构建一个给定文件名的FileWriter对象，使用布尔值标识是否附加写入的数据。

Parameters:

fileName - String The system-dependent filename. 字符串，系统相关的文件名。

append - boolean if true, then data will be written to the end of the file rather than the beginning. 如果布尔值为true，那么数据将被输出至文件末尾而不是开头。

Throws:

IOException - if the named file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot be opened for any other reason 如果该名称的文件存在但是是目录而不是常规文件，或者不存在但不能被创建， 或者其他原因不能打开，则抛出

FileWriter

public FileWriter(File file)
           throws IOException

Constructs a FileWriter object given a File object. 构建一个给定File对象的FileWriter对象。

Parameters:

file - a File object to write to. 要输出的File对象。

Throws:

IOException - if the file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot be opened for any other reason 如果该文件存在但是是目录而不是常规文件，或者不存在但不能被创建， 或者其他原因不能打开，则抛出

FileWriter

public FileWriter(File file,
                  boolean append)
           throws IOException

Constructs a FileWriter object given a File object. If the second argument is true, then bytes will be written to the end of the file rather than the beginning. 构建一个给定File对象的FileWriter对象。如果第二个参数为true，那么字节将被输出至文件末尾而不是开头。

Parameters:

file - a File object to write to 要输出的File对象

append - if true, then bytes will be written to the end of the file rather than the beginning 如果为true，那么字节将被输出至文件末尾而不是开头。

Throws:

IOException - if the file exists but is a directory rather than a regular file, does not exist but cannot be created, or cannot be opened for any other reason 如果该文件存在但是是目录而不是常规文件，或者不存在但不能被创建， 或者其他原因不能打开，则抛出

Since:

1.4

FileWriter

public FileWriter(FileDescriptor fd)

Constructs a FileWriter object associated with a file descriptor. 构建一个与文件描述符关联的FileWriter对象。

Parameters:

fd - FileDescriptor object to write to. 要输出的FileDescriptor对象。

Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.