Класс 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()`	Устарел. Метод `finalize` устарел.
`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.

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

FileImageOutputStream

public FileImageOutputStream(RandomAccessFile raf)

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

Parameters:: raf - RandomAccessFile для записи.
Throws:: IllegalArgumentException - если raf null.

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

read

public int read() throws IOException

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

Считывает один байт из потока и возвращает его как int в диапазоне от 0 до 255. Если достигнут конец потока (EOF), возвращается -1.

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

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

Specified by:: read в интерфейсе ImageInputStream
Specified by:: read в классе ImageInputStreamImpl
Returns:: значение следующего байта в потоке или -1 если достигнут EOF.
Throws:: IOException - если поток закрыт.

read

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

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

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

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

Specified by:: read в интерфейсе ImageInputStream
Specified by:: read в классе ImageInputStreamImpl
Parameters:: b - массив байтов, который будет записан.; off - начальная позиция в b для записи.; len - максимальное количество байтов для чтения.
Returns:: количество фактически прочитанных байтов или -1 для указания EOF.
Throws:: IOException - если произошла ошибка ввода-вывода.

write

public void write(int b) throws IOException

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

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

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

Parameters:: b - int с нижними 8 битами, которые будут записаны.
Throws:: IOException - если произошла ошибка ввода-вывода.

write

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

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

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

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

length

public long length()

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

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

Specified by:: length в интерфейсе ImageInputStream
Overrides:: length в классе ImageInputStreamImpl
Returns:: -1L для указания неизвестной длины.

seek

public void seek(long pos) throws IOException

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

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

close

public void close() throws IOException

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

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

Throws:: IOException - если произошла ошибка ввода-вывода.

finalize

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

Устарело.

Метод finalize устарел. Подклассы, переопределяющие finalize для выполнения очистки, должны быть изменены на использование альтернативных механизмов очистки и удаления переопределённого метода finalize. При переопределении метода finalize, его реализация должна явно гарантировать, что super.finalize() вызывается, как описано в Object.finalize(). См. спецификацию для Object.finalize() для получения дополнительной информации о вариантах миграции.

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

Overrides:

finalize в классе ImageInputStreamImpl

Throws:

Throwable - если при завершении работы суперкласса произошла ошибка.

See Also:

© 1993, 2021, 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/17/docs/api/java.desktop/javax/imageio/stream/FileImageOutputStream.html