Класс FileImageOutputStream

java.lang.Object
- javax.imageio.stream.ImageInputStreamImpl
- - javax.imageio.stream.ImageOutputStreamImpl
  - - 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()` Завершает работу объекта перед сборкой мусора.
`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, 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

Методы, унаследованные от интерфейса javax.imageio.stream.ImageOutputStream

flushBefore

Методы, унаследованные от интерфейса 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

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

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

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

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

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

Определено в:: read в интерфейсе ImageInputStream
Определено в:: read в классе ImageInputStreamImpl
Возвращает:: значение следующего байта в потоке или -1 если достигнут EOF.
Исключения:: 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 для обозначения EOF.
Исключения:: IOException - если произошла ошибка ввода-вывода.

write

public void write(int b)
           throws IOException

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

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

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

Определено в:: write в интерфейсе DataOutput
Определено в:: write в интерфейсе ImageOutputStream
Определено в:: write в классе ImageOutputStreamImpl
Параметры:: b - int, чьи младшие 8 бит будут записаны.
Исключения:: IOException - если произошла ошибка ввода-вывода.

write

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

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

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

Определено в:: write в интерфейсе DataOutput
Определено в:: write в интерфейсе ImageOutputStream
Определено в:: write в классе ImageOutputStreamImpl
Параметры:: b - массив byte для записи.; off - начальный смещение в данных.; len - количество byte для записи.
Исключения:: IOException - если произошла ошибка ввода-вывода.

length

public long length()

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

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

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

seek

public void seek(long pos)
          throws IOException

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

Определено в:: seek в интерфейсе ImageInputStream
Переопределяет:: seek в классе ImageInputStreamImpl
Параметры:: pos - long, содержащий желаемую позицию указателя файла.
Исключения:: IndexOutOfBoundsException - если pos меньше позиции сброса.; 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.