java.io

Класс FileOutputStream

java.lang. Объект

java.io. OutputStream

java.io. FileOutputStream

Все Реализованные Интерфейсы:

Closeable, Flushable, AutoCloseable

public class FileOutputStream
extends OutputStream

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

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

С тех пор:

JDK1.0

См. Также:

File, FileDescriptor, FileInputStream, Files.newOutputStream(java.nio.file.Path, java.nio.file.OpenOption...)

Сводка конструктора

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

Конструктор и Описание
FileOutputStream(File file) Создает поток вывода файла, чтобы записать в файл, представленный указанным File объект.
FileOutputStream(File file, boolean append) Создает поток вывода файла, чтобы записать в файл, представленный указанным File объект.
FileOutputStream(FileDescriptor fdObj) Создает поток вывода файла, чтобы записать в указанный дескриптор файла, который представляет существующее соединение с фактическим файлом в файловой системе.
FileOutputStream(String name) Создает поток вывода файла, чтобы записать в файл с указанным именем.
FileOutputStream(String name, boolean append) Создает поток вывода файла, чтобы записать в файл с указанным именем.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	close() Завершения этот поток вывода файла и выпуски любые системные ресурсы связались с этим потоком.
protected void	finalize() Очищает соединение с файлом, и гарантирует что close метод этого потока вывода файла вызывают, когда нет больше ссылок на этот поток.
FileChannel	getChannel() Возвращает уникальное FileChannel объект связался с этим потоком вывода файла.
FileDescriptor	getFD() Возвращает дескриптор файла, связанный с этим потоком.
void	write(byte[] b) Записи b.length байты от указанного байтового массива до этого потока вывода файла.
void	write(byte[] b, int off, int len) Записи len байты от указанного байтового массива, запускающегося при смещении off к этому потоку вывода файла.
void	write(int b) Пишет указанный байт в этот поток вывода файла.

Методы java.io унаследованный от класса. OutputStream

сброс

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

FileOutputStream

public FileOutputStream(String name)
                 throws FileNotFoundException

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

Во-первых, если есть менеджер безопасности, checkWrite с методом вызывают name как его параметр.

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

Параметры:

name - системно-зависимое имя файла

Броски:

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

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

См. Также:

SecurityManager.checkWrite(java.lang.String)

FileOutputStream

public FileOutputStream(String name,
                boolean append)
                 throws FileNotFoundException

Создает поток вывода файла, чтобы записать в файл с указанным именем. Если второй параметр true, тогда байты будут записаны до конца файла, а не начало. Новое FileDescriptor объект создается, чтобы представить это соединение файла.

Во-первых, если есть менеджер безопасности, checkWrite с методом вызывают name как его параметр.

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

Параметры:

name - системно-зависимое имя файла

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

Броски:

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

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

С тех пор:

JDK1.1

См. Также:

SecurityManager.checkWrite(java.lang.String)

FileOutputStream

public FileOutputStream(File file)
                 throws FileNotFoundException

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

Во-первых, если есть менеджер безопасности, checkWrite метод вызывают с путем, представленным file параметр как его параметр.

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

Параметры:

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

Броски:

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

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

См. Также:

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

FileOutputStream

public FileOutputStream(File file,
                boolean append)
                 throws FileNotFoundException

Создает поток вывода файла, чтобы записать в файл, представленный указанным File объект. Если второй параметр true, тогда байты будут записаны до конца файла, а не начало. Новое FileDescriptor объект создается, чтобы представить это соединение файла.

Во-первых, если есть менеджер безопасности, checkWrite метод вызывают с путем, представленным file параметр как его параметр.

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

Параметры:

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

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

Броски:

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

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

С тех пор:

1.4

См. Также:

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

FileOutputStream

public FileOutputStream(FileDescriptor fdObj)

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

Во-первых, если есть менеджер безопасности, checkWrite метод вызывают с дескриптором файла fdObj параметр как его параметр.

Если fdObj нуль тогда a NullPointerException бросается.

Этот конструктор не выдает исключение если fdObj invalid. Однако, если методы вызываются на получающийся поток, чтобы делать попытку ввода-вывода на потоке, IOException бросается.

Параметры:

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

Броски:

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

См. Также:

SecurityManager.checkWrite(java.io.FileDescriptor)

Деталь метода

записать

public void write(int b)
           throws IOException

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

Определенный:

write в классе OutputStream

Параметры:

b - байт, который будет записан.

Броски:

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

записать

public void write(byte[] b)
           throws IOException

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

Переопределения:

write в классе OutputStream

Параметры:

b - данные.

Броски:

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

См. Также:

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

записать

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

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

Переопределения:

write в классе OutputStream

Параметры:

b - данные.

off - запуск смещается в данных.

len - число байтов, чтобы записать.

Броски:

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

близко

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()

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

Начальная буква позиция из возвращенного канала будет равно числу байтов, записанных файлу до сих пор, если этот поток не находится в, добавляют режим, когда это будет равно размеру файла. Запись байтов к этому потоку постепенно увеличит позицию канала соответственно. Изменение позиции канала, или явно или при записи, изменит позицию файла этого потока.

Возвраты:

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

С тех пор:

1.4

завершить

protected void finalize()
                 throws IOException

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

Переопределения:

finalize в классе Object

Броски:

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

См. Также:

FileInputStream.close()