Класс FileOutputStream

public FileOutputStream(String name) throws FileNotFoundException

Требования к реализации:

Вызов этого конструктора с параметром name эквивалентен вызову new FileOutputStream(name, false).

Параметры:

name — зависящее от системы имя файла

Выбрасывает:

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

public FileOutputStream(String name, boolean append) throws FileNotFoundException

Параметры:

name — зависящее от системы имя файла

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

Выбрасывает:

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

С версии:

1.1

public FileOutputStream(File file) throws FileNotFoundException

Параметры:

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

Выбрасывает:

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

См. также:

• File.getPath()

public FileOutputStream(File file, boolean append) throws FileNotFoundException

Параметры:

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

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

Выбрасывает:

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

С версии:

1.4

См. также:

• File.getPath()

public FileOutputStream(FileDescriptor fdObj)

Параметры:

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

public void write(int b) throws IOException

Определено в:

write в классе OutputStream

Параметры:

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

Выбрасывает:

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

public void write(byte[] b) throws IOException

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

write в классе OutputStream

Параметры:

b — данные.

Выбрасывает:

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

См. также:

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

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

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

write в классе OutputStream

Параметры:

b — данные.

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

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

Выбрасывает:

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

IndexOutOfBoundsException — если off отрицательно, len отрицательно или len больше, чем b.length - off

public void close() throws IOException

Определено в:

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

Определено в:

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

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

close в классе OutputStream

Примечание к API:

Переопределение close() для выполнения действий по очистке надежно только при прямом вызове или вызове с помощью конструкции try-with-resources.

Требования к реализации:

Подклассам, которым необходимо очищать ресурсы после того, как поток становится недостижимым, следует использовать механизм Cleaner.

Если с этим потоком связан канал, этот метод закроет канал, что, в свою очередь, закроет этот поток. Подклассы, переопределяющие этот метод, должны быть готовы к возможному повторному входу в метод.

Выбрасывает:

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

public final FileDescriptor getFD() throws IOException

Возвращает:

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

Выбрасывает:

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

См. также:

• FileDescriptor

public FileChannel getChannel()

Возвращает:

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

С версии:

1.4