Класс FileOutputStream

public class FileOutputStream
extends OutputStream

Поток вывода для файла — это поток вывода для записи данных в File или в FileDescriptor. Доступность или возможность создания файла зависят от базовой платформы. Некоторые платформы, в частности, разрешают открытие файла для записи только одним FileOutputStream (или другим объектом записи в файл) за раз. В таких ситуациях конструкторы этого класса завершатся ошибкой, если соответствующий файл уже открыт.

FileOutputStream предназначен для записи потоков необработанных байтов, таких как данные изображения. Для записи потоков символов используйте FileWriter.

Конструкторы

FileOutputStream

public FileOutputStream(String name)
                 throws FileNotFoundException

Параметры:

name - имя файла, зависящее от операционной системы

Исключения:

FileNotFoundException - если файл существует, но является каталогом, а не обычным файлом, не существует, но не может быть создан, или не может быть открыт по какой-либо другой причине

SecurityException - если менеджер безопасности существует и его метод checkWrite запрещает запись в файл.

См. также:

SecurityManager.checkWrite(java.lang.String)

FileOutputStream

public FileOutputStream(String name,
                        boolean append)
                 throws FileNotFoundException

Параметры:

name - имя файла, зависящее от операционной системы

append - если true, то байты будут записаны в конец файла, а не в начало

Исключения:

FileNotFoundException - если файл существует, но является каталогом, а не обычным файлом, не существует, но не может быть создан, или не может быть открыт по какой-либо другой причине.

SecurityException - если менеджер безопасности существует и его метод checkWrite запрещает запись в файл.

С тех пор:

JDK1.1

См. также:

SecurityManager.checkWrite(java.lang.String)

FileOutputStream

public FileOutputStream(File file)
                 throws FileNotFoundException

Параметры:

file - файл, который должен быть открыт для записи.

Исключения:

FileNotFoundException - если файл существует, но является каталогом, а не обычным файлом, не существует, но не может быть создан, или не может быть открыт по какой-либо другой причине

SecurityException - если менеджер безопасности существует и его метод checkWrite запрещает запись в файл.

См. также:

File.getPath(), SecurityException, SecurityManager.checkWrite(java.lang.String)

FileOutputStream

public FileOutputStream(File file,
                        boolean append)
                 throws FileNotFoundException

Параметры:

file - файл, который должен быть открыт для записи.

append - если true, то байты будут записаны в конец файла, а не в начало

Исключения:

FileNotFoundException - если файл существует, но является каталогом, а не обычным файлом, не существует, но не может быть создан, или не может быть открыт по какой-либо другой причине

SecurityException - если менеджер безопасности существует и его метод checkWrite запрещает запись в файл.

С тех пор:

1.4

См. также:

File.getPath(), SecurityException, SecurityManager.checkWrite(java.lang.String)

FileOutputStream

public FileOutputStream(FileDescriptor fdObj)

Параметры:

fdObj - дескриптор файла, который должен быть открыт для записи

Исключения:

SecurityException - если менеджер безопасности существует и его метод checkWrite запрещает запись в дескриптор файла

См. также:

SecurityManager.checkWrite(java.io.FileDescriptor)

Методы

write

public void write(int b)
           throws IOException

Записывает указанный байт в этот поток вывода в файл. Реализует метод write класса OutputStream.

Указано в:

write в классе OutputStream

Параметры:

b - байт для записи.

Исключения:

IOException - если происходит ошибка ввода-вывода.

write

public void write(byte[] b)
           throws IOException

Записывает b.length байтов из указанного массива байтов в этот поток вывода в файл.

Переопределяет:

write в классе OutputStream

Параметры:

b - данные.

Исключения:

IOException - если происходит ошибка ввода-вывода.

См. также:

OutputStream.write(byte[], int, int)

write

public void write(byte[] b,
                  int off,
                  int len)
           throws IOException

Записывает len байтов из указанного массива байтов, начиная с смещения off в этот поток вывода в файл.

Переопределяет:

write в классе OutputStream

Параметры:

b - данные.

off - начальное смещение в данных.

len - количество байтов для записи.

Исключения:

IOException - если происходит ошибка ввода-вывода.

close

public void close()
           throws IOException

Указано в:

close в интерфейсе Closeable

Указано в:

close в интерфейсе AutoCloseable

Переопределяет:

close в классе OutputStream

Исключения:

IOException - если происходит ошибка ввода-вывода.

getFD

public final FileDescriptor getFD()
                           throws IOException

Возвращает дескриптор файла, связанный с этим потоком.

Возвращает:

объект FileDescriptor, который представляет соединение с файлом в файловой системе, используемое этим объектом FileOutputStream.

Исключения:

IOException - если происходит ошибка ввода-вывода.

См. также:

FileDescriptor

getChannel

public FileChannel getChannel()

Возвращает:

канал файла, связанный с этим потоком вывода в файл

С тех пор:

1.4

finalize

protected void finalize()
                 throws IOException

Очищает соединение с файлом и гарантирует, что метод close этого потока вывода в файл будет вызван, когда больше нет ссылок на этот поток.

Переопределяет:

finalize в классе Object

Исключения:

IOException - если происходит ошибка ввода-вывода.

См. также:

FileInputStream.close()