Class FileWriter

java.lang.Object
java.io.Writer
java.io.OutputStreamWriter
java.io.FileWriter
All Implemented Interfaces:
Closeable,Flushable,Appendable,AutoCloseable
public classFileWriterextendsOutputStreamWriter
Writes text to character files using a default buffer size. Encoding from characters to bytes uses either a specifiedcharset or thedefault charset.

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 oneFileWriter (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.

TheFileWriter is meant for writing streams of characters. For writing streams of raw bytes, consider using aFileOutputStream.

Since:
1.1
See Also:

  • Constructor Details

    • FileWriter

      public FileWriter(String fileName) throwsIOException
      Constructs aFileWriter given a file name, using thedefault charset
      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
      See Also:

    • FileWriter

      public FileWriter(String fileName, boolean append) throwsIOException
      Constructs aFileWriter given a file name and a boolean indicating whether to append the data written, using thedefault charset.
      Parameters:
      fileName - String The system-dependent filename.
      append - boolean iftrue, then data will be written to the end of the file rather than the beginning.
      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
      See Also:

    • FileWriter

      public FileWriter(File file) throwsIOException
      Constructs aFileWriter given theFile to write, using thedefault charset
      Parameters:
      file - theFile to write.
      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
      See Also:

    • FileWriter

      public FileWriter(File file, boolean append) throwsIOException
      Constructs aFileWriter given theFile to write and a boolean indicating whether to append the data written, using thedefault charset.
      Parameters:
      file - theFile to write
      append - iftrue, then bytes will be written to the end of the file rather than the beginning
      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
      See Also:

    • FileWriter

      public FileWriter(FileDescriptor fd)
      Constructs aFileWriter given a file descriptor, using thedefault charset.
      Parameters:
      fd - theFileDescriptor to write.
      See Also:

    • FileWriter

      public FileWriter(String fileName,Charset charset) throwsIOException
      Constructs aFileWriter given a file name andcharset.
      Parameters:
      fileName - the name of the file to write
      charset - thecharset
      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
      Since:
      11

    • FileWriter

      public FileWriter(String fileName,Charset charset, boolean append) throwsIOException
      Constructs aFileWriter given a file name,charset and a boolean indicating whether to append the data written.
      Parameters:
      fileName - the name of the file to write
      charset - thecharset
      append - a boolean. Iftrue, the writer will write the data to the end of the file rather than the beginning.
      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
      Since:
      11

    • FileWriter

      public FileWriter(File file,Charset charset) throwsIOException
      Constructs aFileWriter given theFile to write andcharset.
      Parameters:
      file - theFile to write
      charset - thecharset
      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:
      11

    • FileWriter

      public FileWriter(File file,Charset charset, boolean append) throwsIOException
      Constructs aFileWriter given theFile to write,charset and a boolean indicating whether to append the data written.
      Parameters:
      file - theFile to write
      charset - thecharset
      append - a boolean. Iftrue, the writer will write the data to the end of the file rather than the beginning.
      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:
      11