Spec-Zone .ru
спецификации, руководства, описания, API
|
public class FileOutputStream extends OutputStream
File
или к a FileDescriptor
. Доступен ли файл или может быть создан, зависит от базовой платформы. Некоторые платформы, в частности позволяют файлу быть открытым для того, чтобы записать только одним FileOutputStream (или другой пишущий файл объект) за один раз. В таких ситуациях перестанут работать конструкторы в этом class, если включенный файл будет уже открыт. FileOutputStream
предназначается для записи потоков необработанных байтов, таких как данные изображения. Для того, чтобы записать потоки символов, рассмотреть использование FileWriter
.
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)
Пишет указанный байт в этот поток вывода файла.
|
сброс
public FileOutputStream(String name) throws FileNotFoundException
FileDescriptor
объект создается, чтобы представить это соединение файла. Во-первых, если есть менеджер безопасности, checkWrite
с методом вызывают name
как его параметр.
Если файл существует, но является каталогом, а не регулярным файлом, не существует, но не может быть создан, или не может быть открыт ни по какой другой причине тогда a FileNotFoundException
бросается.
name
- системно-зависимое имя файлаFileNotFoundException
- если файл существует, но является каталогом, а не регулярным файлом, не существует, но не может быть создан, или не может быть открыт ни по какой другой причинеSecurityException
- если менеджер безопасности существует и checkWrite
метод отрицает доступ для записи к файлу.SecurityManager.checkWrite(java.lang.String)
public FileOutputStream(String name, boolean append) throws FileNotFoundException
true
, тогда байты будут записаны до конца файла, а не начало. Новое FileDescriptor
объект создается, чтобы представить это соединение файла. Во-первых, если есть менеджер безопасности, checkWrite
с методом вызывают name
как его параметр.
Если файл существует, но является каталогом, а не регулярным файлом, не существует, но не может быть создан, или не может быть открыт ни по какой другой причине тогда a FileNotFoundException
бросается.
name
- системно-зависимое имя файлаappend
- если true
, тогда байты будут записаны до конца файла, а не началоFileNotFoundException
- если файл существует, но является каталогом, а не регулярным файлом, не существует, но не может быть создан, или не может быть открыт ни по какой другой причине.SecurityException
- если менеджер безопасности существует и checkWrite
метод отрицает доступ для записи к файлу.SecurityManager.checkWrite(java.lang.String)
public FileOutputStream(File file) throws FileNotFoundException
File
объект. Новое FileDescriptor
объект создается, чтобы представить это соединение файла. Во-первых, если есть менеджер безопасности, checkWrite
метод вызывают с путем, представленным file
параметр как его параметр.
Если файл существует, но является каталогом, а не регулярным файлом, не существует, но не может быть создан, или не может быть открыт ни по какой другой причине тогда a FileNotFoundException
бросается.
file
- файл, который будет открыт для того, чтобы записать.FileNotFoundException
- если файл существует, но является каталогом, а не регулярным файлом, не существует, но не может быть создан, или не может быть открыт ни по какой другой причинеSecurityException
- если менеджер безопасности существует и checkWrite
метод отрицает доступ для записи к файлу.File.getPath()
, SecurityException
, SecurityManager.checkWrite(java.lang.String)
public FileOutputStream(File file, boolean append) throws FileNotFoundException
File
объект. Если второй параметр true
, тогда байты будут записаны до конца файла, а не начало. Новое FileDescriptor
объект создается, чтобы представить это соединение файла. Во-первых, если есть менеджер безопасности, checkWrite
метод вызывают с путем, представленным file
параметр как его параметр.
Если файл существует, но является каталогом, а не регулярным файлом, не существует, но не может быть создан, или не может быть открыт ни по какой другой причине тогда a FileNotFoundException
бросается.
file
- файл, который будет открыт для того, чтобы записать.append
- если true
, тогда байты будут записаны до конца файла, а не началоFileNotFoundException
- если файл существует, но является каталогом, а не регулярным файлом, не существует, но не может быть создан, или не может быть открыт ни по какой другой причинеSecurityException
- если менеджер безопасности существует и checkWrite
метод отрицает доступ для записи к файлу.File.getPath()
, SecurityException
, SecurityManager.checkWrite(java.lang.String)
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
в class OutputStream
b
- байт, который будет записан.IOException
- если ошибка ввода-вывода происходит.public void write(byte[] b) throws IOException
b.length
байты от указанного байтового массива до этого потока вывода файла.write
в class OutputStream
b
- данные.IOException
- если ошибка ввода-вывода происходит.OutputStream.write(byte[], int, int)
public void write(byte[] b, int off, int len) throws IOException
len
байты от указанного байтового массива, запускающегося при смещении off
к этому потоку вывода файла.write
в class OutputStream
b
- данные.off
- запуск смещается в данных.len
- число байтов, чтобы записать.IOException
- если ошибка ввода-вывода происходит.public void close() throws IOException
Если у этого потока есть связанный канал тогда, канал закрывается также.
close
в интерфейсе Closeable
close
в интерфейсе AutoCloseable
close
в class OutputStream
IOException
- если ошибка ввода-вывода происходит.public final FileDescriptor getFD() throws IOException
FileDescriptor
объект, который представляет соединение с файлом в файловой системе, используемой этим FileOutputStream
объект.IOException
- если ошибка ввода-вывода происходит.FileDescriptor
public FileChannel getChannel()
FileChannel
объект связался с этим потоком вывода файла.
Начальная буква позиция
из возвращенного канала будет равно числу байтов, записанных файлу до сих пор, если этот поток не находится в, добавляют режим, когда это будет равно размеру файла. Запись байтов к этому потоку постепенно увеличит позицию канала соответственно. Изменение позиции канала, или явно или при записи, изменит позицию файла этого потока.
protected void finalize() throws IOException
close
метод этого потока вывода файла вызывают, когда нет больше ссылок на этот поток.finalize
в class Object
IOException
- если ошибка ввода-вывода происходит.FileInputStream.close()
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92