Класс 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