Класс FileImageInputStream

java.lang.Object
- javax.imageio.stream.ImageInputStreamImpl
- - javax.imageio.stream.FileImageInputStream

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

public class FileImageInputStream
extends ImageInputStreamImpl

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

Поля

Поля, унаследованные от класса javax.imageio.stream.ImageInputStreamImpl

bitOffset, byteOrder, flushedPos, streamPos

Конструкторы

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

Методы

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

Методы, унаследованные от класса javax.imageio.stream.ImageInputStreamImpl

checkClosed, 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, setBitOffset, setByteOrder, skipBytes, skipBytes

Методы, унаследованные от класса java.lang.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.; SecurityException - если менеджер безопасности существует и не разрешает чтение файла.; 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.

seek

public void seek(long pos)
          throws IOException

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

Устанавливает текущую позицию потока в нужное место. Следующее чтение произойдёт в этом месте. Сдвиг бита сбрасывается в 0.

Будет брошено исключение IndexOutOfBoundsException, если pos меньше позиции сброса (как возвращается методом getflushedPosition).

Разрешается перемещаться за конец файла; исключение java.io.EOFException будет брошено только при чтении.

Указано в:: seek в интерфейсе ImageInputStream
Переопределяет:: seek в классе ImageInputStreamImpl
Параметры:: pos - long, содержащий желаемую позицию указателя файла.
Исключения:: IOException - если произошла любая другая ошибка ввода-вывода.

close

public void close()
           throws IOException

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

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

Указано в:: close в интерфейсе Closeable
Указано в:: close в интерфейсе AutoCloseable
Указано в:: close в интерфейсе ImageInputStream
Переопределяет:: close в классе ImageInputStreamImpl
Исключения:: IOException - если произошла ошибка ввода-вывода.

finalize

protected void finalize()
                 throws Throwable

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

Переопределяет:: finalize в классе ImageInputStreamImpl
Исключения:: Throwable - если произошла ошибка во время инициализации суперкласса.
См. также:: WeakReference, PhantomReference

© 1993, 2020, 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.