Класс 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.; SecurityException - если менеджер безопасности существует и не разрешает доступ к записи в файл.; FileNotFoundException - если f не обозначает обычный файл или его нельзя открыть для чтения и записи по какой-либо другой причине.; IOException - если произошла ошибка ввода-вывода.

FileImageOutputStream

public FileImageOutputStream(RandomAccessFile raf)

Создаёт FileImageOutputStream для записи в указанный RandomAccessFile.

Параметры:: raf - RandomAccessFile для записи.
Исключения:: IllegalArgumentException - если raf является null.

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

read

public int read() throws IOException

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

Считывает один байт из потока и возвращает его как целое число с плавающей точкой от 0 до 255. Если достигнут конец потока (EOF), возвращается -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 - целое число, нижние 8 битов которого будут записаны.
Исключения:: IOException - если произошла ошибка ввода-вывода.

write

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

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

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

Параметры:: b - массив байтов для записи.; off - смещение начала данных.; len - количество байтов для записи.
Исключения:: 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, 2023, 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/21/docs/api/java.desktop/javax/imageio/stream/FileImageOutputStream.html