Класс FileImageOutputStream

javax.imageio.stream.FileImageOutputStream

Все реализуемые интерфейсы:: Closeable, DataInput, DataOutput, AutoCloseable, ImageInputStream, ImageOutputStream

public class FileImageOutputStream extends ImageOutputStreamImpl

Реализация ImageOutputStream, которая записывает выходные данные непосредственно в File или RandomAccessFile.

Краткое описание полей

Поля, объявленные в классе ImageInputStreamImpl

bitOffset, byteOrder, flushedPos, streamPos

Краткое описание конструкторов

Конструктор	Описание
`FileImageOutputStream(File f)`	Создает `FileImageOutputStream`, который будет записывать данные в указанный `File`.
`FileImageOutputStream(RandomAccessFile raf)`	Создает `FileImageOutputStream`, который будет записывать данные в указанный `RandomAccessFile`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`close()`	Закрывает поток.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежащей удалению.
`long`	`length()`	Возвращает `-1L`, указывающее, что длина потока неизвестна.
`int`	`read()`	Читает из потока один байт и возвращает его как `int` в диапазоне от 0 до 255.
`int`	`read(byte[] b, int off, int len)`	Читает из потока не более `len` байт и сохраняет их в `b`, начиная с индекса `off`.
`void`	`seek(long pos)`	Устанавливает текущую позицию в потоке и сбрасывает смещение бита в 0.
`void`	`write(byte[] b, int off, int len)`	Записывает последовательность байтов в поток в текущей позиции.
`void`	`write(int b)`	Записывает один байт в поток в текущей позиции.

Методы, объявленные в классе ImageOutputStreamImpl

flushBits, write, writeBit, writeBits, writeBoolean, writeByte, writeBytes, writeChar, writeChars, writeChars, writeDouble, writeDoubles, writeFloat, writeFloats, writeInt, writeInts, writeLong, writeLongs, writeShort, writeShorts, writeUTF

Методы, объявленные в классе ImageInputStreamImpl

checkClosed, close, flush, flushBefore, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, isCached, isCachedFile, isCachedMemory, length, mark, read, readBit, readBits, readBoolean, readByte, readBytes, readChar, readDouble, readFloat, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readInt, readLine, readLong, readShort, readUnsignedByte, readUnsignedInt, readUnsignedShort, readUTF, reset, setBitOffset, setByteOrder, skipBytes, skipBytes

Методы, объявленные в классе Object

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

Методы, объявленные в интерфейсе ImageInputStream

flush, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, isCached, isCachedFile, isCachedMemory, mark, read, readBit, readBits, readBoolean, readByte, readBytes, readChar, readDouble, readFloat, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readInt, readLine, readLong, readShort, readUnsignedByte, readUnsignedInt, readUnsignedShort, readUTF, reset, setBitOffset, setByteOrder, skipBytes, skipBytes

Методы, объявленные в интерфейсе ImageOutputStream

flushBefore

Подробное описание конструкторов

FileImageOutputStream

public FileImageOutputStream(File f) throws FileNotFoundException, IOException

Создает FileImageOutputStream, который будет записывать данные в указанный File.

Параметры:: f — File, в который выполняется запись.
Исключения:: IllegalArgumentException — если f равно null.; FileNotFoundException — если f не указывает на обычный файл или по какой-либо другой причине его невозможно открыть для чтения и записи.; IOException — если возникает ошибка ввода-вывода.

FileImageOutputStream

public FileImageOutputStream(RandomAccessFile raf)

Создает FileImageOutputStream, который будет записывать данные в указанный RandomAccessFile.

Параметры:: raf — RandomAccessFile, в который выполняется запись.
Исключения:: IllegalArgumentException — если raf равно null.

Подробное описание методов

read

public int read() throws IOException

Описание скопировано из класса: ImageInputStreamImpl

Читает из потока один байт и возвращает его как int в диапазоне от 0 до 255. Если достигнут конец файла, возвращается -1.

Подклассы должны предоставить реализацию этого метода. Реализация подкласса должна обновить позицию в потоке перед завершением.

Перед чтением смещение бита в потоке должно быть сброшено в ноль.

Определено в:: read в интерфейсе ImageInputStream
Определено в:: read в классе ImageInputStreamImpl
Возвращает:: значение следующего байта в потоке или -1, если достигнут конец файла.
Исключения:: IOException — если поток закрыт.

read

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

Описание скопировано из класса: ImageInputStreamImpl

Читает из потока не более len байт и сохраняет их в b, начиная с индекса off. Если чтение невозможно, поскольку достигнут конец потока, возвращается -1.

Перед чтением смещение бита в потоке должно быть сброшено в ноль.

Определено в:: read в интерфейсе ImageInputStream
Определено в:: read в классе ImageInputStreamImpl
Параметры:: b — массив байтов для записи.; off — начальная позиция в b, с которой выполняется запись.; len — максимальное количество байтов для чтения.
Возвращает:: фактическое количество прочитанных байтов или -1, обозначающее конец файла.
Исключения:: IOException — если возникает ошибка ввода-вывода.

write

public void write(int b) throws IOException

Описание скопировано из интерфейса: ImageOutputStream

Записывает один байт в поток в текущей позиции. 24 старших бита b игнорируются.

Если смещение бита в потоке не равно нулю, оставшаяся часть текущего байта дополняется нулями и сначала записывается в выходной поток. После записи смещение бита будет равно 0. Для этого реализующие интерфейс классы могут использовать метод flushBits класса ImageOutputStreamImpl.

Параметры:: b — int, младшие 8 бит которого нужно записать.
Исключения:: IOException — если возникает ошибка ввода-вывода.

write

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

Описание скопировано из интерфейса: ImageOutputStream

Записывает последовательность байтов в поток в текущей позиции. Если len равно 0, ничего не записывается. Сначала записывается байт b[off], затем байт b[off + 1] и так далее.

Параметры:: b — массив byte для записи.; off — начальное смещение в данных.; len — количество byte для записи.
Исключения:: IOException — если возникает ошибка ввода-вывода.

length

public long length()

Описание скопировано из класса: ImageInputStreamImpl

Возвращает -1L, указывающее, что длина потока неизвестна. Подклассы должны переопределить этот метод, чтобы предоставить сведения о фактической длине.

Определено в:: length в интерфейсе ImageInputStream
Переопределяет:: length в классе ImageInputStreamImpl
Возвращает:: -1L, обозначающее неизвестную длину.

seek

public void seek(long pos) throws IOException

Устанавливает текущую позицию в потоке и сбрасывает смещение бита в 0. Допускается переход за конец файла; EOFException будет вызвано только при чтении. Длина файла не увеличится до выполнения записи.

Параметры:: pos — long, содержащий требуемую позицию указателя файла.
Исключения:: IndexOutOfBoundsException — если pos меньше позиции сброса.; IOException — если возникает другая ошибка ввода-вывода.

close

public void close() throws IOException

Описание скопировано из интерфейса: ImageInputStream

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

Исключения:: IOException — если возникает ошибка ввода-вывода.

finalize

@Deprecated(since="9", forRemoval=true) protected void finalize() throws Throwable

Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.

Финализация объявлена устаревшей и подлежащей удалению. Справочную информацию и сведения о вариантах миграции см. в Object.finalize().

Выполняет финализацию этого объекта перед сборкой мусора. Метод close вызывается для закрытия всех открытых источников ввода. Этот метод не следует вызывать из кода приложения.

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

finalize в классе ImageInputStreamImpl

Исключения:

Throwable — если при финализации суперкласса возникает ошибка.

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/imageio/stream/FileImageOutputStream.html