Класс FileCacheImageInputStream

java.lang.Object

javax.imageio.stream.ImageInputStreamImpl

javax.imageio.stream.FileCacheImageInputStream

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

public class FileCacheImageInputStream extends ImageInputStreamImpl

Реализация ImageInputStream, получающая входные данные из обычного InputStream. Для кэширования ранее прочитанных данных используется файл.

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

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

bitOffset, byteOrder, flushedPos, streamPos

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

Конструктор	Описание
`FileCacheImageInputStream(InputStream stream, File cacheDir)`	Создает `FileCacheImageInputStream`, который будет считывать данные из заданного `InputStream`.

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

Модификатор и тип	Метод	Описание
`void`	`close()`	Закрывает этот `FileCacheImageInputStream`, закрывая и удаляя файл кэша.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и планируется к удалению.
`boolean`	`isCached()`	Возвращает `true`, поскольку этот `ImageInputStream` кэширует данные, чтобы разрешить перемещение назад.
`boolean`	`isCachedFile()`	Возвращает `true`, поскольку этот `ImageInputStream` поддерживает файловый кэш.
`boolean`	`isCachedMemory()`	Возвращает `false`, поскольку этот `ImageInputStream` не поддерживает кэш в основной памяти.
`int`	`read()`	Считывает из потока один байт и возвращает его как `int` в диапазоне от 0 до 255.
`int`	`read(byte[] b, int off, int len)`	Считывает из потока не более `len` байт и сохраняет их в `b` начиная с индекса `off`.

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

checkClosed, flush, flushBefore, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, 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, seek, setBitOffset, setByteOrder, skipBytes, skipBytes

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

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

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

FileCacheImageInputStream

public FileCacheImageInputStream(InputStream stream, File cacheDir) throws IOException

Создает FileCacheImageInputStream, который будет считывать данные из заданного InputStream.

В качестве кэша используется временный файл. Если cacheDir не-null и является каталогом, файл будет создан в этом каталоге. Если это null, будет использоваться системный каталог временных файлов по умолчанию (подробности см. в документации к File.createTempFile).

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

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

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 — если произошла ошибка ввода-вывода.

isCached

public boolean isCached()

Возвращает true, поскольку этот ImageInputStream кэширует данные, чтобы разрешить перемещение назад.

Определено в:

isCached в интерфейсе ImageInputStream

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

isCached в классе ImageInputStreamImpl

Возвращает:

true.

См. также:

isCachedFile

public boolean isCachedFile()

Возвращает true, поскольку этот ImageInputStream поддерживает файловый кэш.

Определено в:

isCachedFile в интерфейсе ImageInputStream

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

isCachedFile в классе ImageInputStreamImpl

Возвращает:

true.

См. также:

isCachedMemory

public boolean isCachedMemory()

Возвращает false, поскольку этот ImageInputStream не поддерживает кэш в основной памяти.

Определено в:

isCachedMemory в интерфейсе ImageInputStream

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

isCachedMemory в классе ImageInputStreamImpl

Возвращает:

false.

См. также:

close

public void close() throws IOException

Закрывает этот FileCacheImageInputStream, закрывая и удаляя файл кэша. Исходный InputStream не закрывается.

Исключения:: 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/FileCacheImageInputStream.html