Класс FileImageInputStream

java.lang.Object

javax.imageio.stream.ImageInputStreamImpl

javax.imageio.stream.FileImageInputStream

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

public class FileImageInputStream extends ImageInputStreamImpl

Реализация ImageInputStream, получающая входные данные из File или RandomAccessFile. Предполагается, что содержимое файла остается неизменным в течение всего срока существования объекта.

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

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

bitOffset, byteOrder, flushedPos, streamPos

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

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

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

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

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

checkClosed, close, flush, flushBefore, 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, seek, setBitOffset, setByteOrder, skipBytes, skipBytes

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

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

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

FileImageInputStream

public FileImageInputStream(File f) throws FileNotFoundException, IOException

Создает FileImageInputStream, который будет читать данные из указанного File.

Содержимое файла не должно изменяться с момента создания этого объекта до момента последнего вызова метода чтения.

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

FileImageInputStream

public FileImageInputStream(RandomAccessFile raf)

Создает FileImageInputStream, который будет читать данные из указанного 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 — если возникает ошибка ввода-вывода.

length

public long length()

Возвращает длину базового файла или -1, если она неизвестна.

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

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/FileImageInputStream.html