Класс FileImageOutputStream

javax.imageio.stream.FileImageOutputStream

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

public class FileImageOutputStream extends ImageOutputStreamImpl

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

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

Поля, объявленные в классе javax.imageio.stream.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)`	Записывает один байт в поток по текущей позиции.

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

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

Методы, объявленные в классе javax.imageio.stream.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

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

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

Методы, объявленные в интерфейсе javax.imageio.stream.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

Методы, объявленные в интерфейсе javax.imageio.stream.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. Если достигнут конец файла (EOF), возвращается -1.

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

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

Указано в:: read в интерфейсе ImageInputStream
Указано в:: read в классе ImageInputStreamImpl
Возвращает:: значение следующего байта в потоке, или -1, если достигнут конец файла (EOF).
Исключения:: 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, чтобы указать конец файла (EOF).
Исключения:: 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/imageio/stream/FileImageOutputStream.html