Класс ImageOutputStreamImpl

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

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

Прямые известные подклассы:: FileCacheImageOutputStream, FileImageOutputStream, MemoryCacheImageOutputStream

public abstract class ImageOutputStreamImpl
extends ImageInputStreamImpl
implements ImageOutputStream

Абстрактный класс, реализующий интерфейс ImageOutputStream. Этот класс разработан для сокращения количества методов, которые должны быть реализованы подклассами.

Поля

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

bitOffset, byteOrder, flushedPos, streamPos

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

Конструктор и описание
`ImageOutputStreamImpl()` Создаёт `ImageOutputStreamImpl`.

Методы

Модификатор и тип	Метод и описание
`protected void`	`flushBits()` Если смещение бита не равно нулю, принудительно устанавливает оставшиеся биты в текущем байте в 0 и перемещает позицию потока на один байт.
`void`	`write(byte[] b)` Записывает последовательность байтов в поток по текущей позиции.
`abstract void`	`write(byte[] b, int off, int len)` Записывает последовательность байтов в поток по текущей позиции.
`abstract void`	`write(int b)` Записывает один байт в поток по текущей позиции.
`void`	`writeBit(int bit)` Записывает один бит, заданный наименее значимым битом аргумента, в поток по текущему битовому смещению в текущей позиции байта.
`void`	`writeBits(long bits, int numBits)` Записывает последовательность битов, заданных `numBits` наименее значимыми битами `bits` аргумента в порядке слева направо, в поток по текущему битовому смещению в текущей позиции байта.
`void`	`writeBoolean(boolean v)` Записывает значение `boolean` в поток.
`void`	`writeByte(int v)` Записывает 8 младших битов `v` в поток.
`void`	`writeBytes(String s)` Записывает строку в выходной поток.
`void`	`writeChar(int v)` Этот метод является синонимом для `writeShort`.
`void`	`writeChars(char[] c, int off, int len)` Записывает последовательность символов в поток по текущей позиции.
`void`	`writeChars(String s)` Записывает строку в выходной поток.
`void`	`writeDouble(double v)` Записывает значение `double`, состоящее из четырёх байтов, в выходной поток.
`void`	`writeDoubles(double[] d, int off, int len)` Записывает последовательность значений типа double в поток по текущей позиции.
`void`	`writeFloat(float v)` Записывает значение `float`, состоящее из четырёх байтов, в выходной поток.
`void`	`writeFloats(float[] f, int off, int len)` Записывает последовательность значений типа float в поток по текущей позиции.
`void`	`writeInt(int v)` Записывает 32 бита значения `v` в поток.
`void`	`writeInts(int[] i, int off, int len)` Записывает последовательность значений типа int в поток по текущей позиции.
`void`	`writeLong(long v)` Записывает 64 бита значения `v` в поток.
`void`	`writeLongs(long[] l, int off, int len)` Записывает последовательность значений типа long в поток по текущей позиции.
`void`	`writeShort(int v)` Записывает 16 младших битов `v` в поток.
`void`	`writeShorts(short[] s, int off, int len)` Записывает последовательность значений типа short в поток по текущей позиции.
`void`	`writeUTF(String s)` Записывает два байта информации о длине в выходной поток в сетевом порядке байтов, а затем — представление модифицированной кодировки UTF-8 каждого символа в строке `s`.

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

checkClosed, close, finalize, flush, flushBefore, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, isCached, isCachedFile, isCachedMemory, length, mark, read, read, 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

Методы, унаследованные от класса java.lang.Object

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

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

flushBefore

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

close, flush, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, isCached, isCachedFile, isCachedMemory, length, mark, read, read, 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

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

ImageOutputStreamImpl

public ImageOutputStreamImpl()

Создаёт ImageOutputStreamImpl.

Методы

write

public abstract void write(int b)
                    throws IOException

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

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

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

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

write

public void write(byte[] b)
           throws IOException

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

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

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

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

write

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

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

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

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

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

writeBoolean

public void writeBoolean(boolean v)
                  throws IOException

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

Записывает значение булевого типа в поток. Если v равно true, записывается значение (byte)1; если v равно false, записывается значение (byte)0.

Определено:: writeBoolean в интерфейсе DataOutput
Определено:: writeBoolean в интерфейсе ImageOutputStream
Параметры:: v - значение булевого типа для записи.
Исключения:: IOException - если произошла ошибка ввода/вывода.

writeByte

public void writeByte(int v)
               throws IOException

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

Записывает 8 младших битов v в поток. 24 старших бита v игнорируются. (Это означает, что writeByte делает ровно то же, что и write для целочисленного аргумента.)

Определено:: writeByte в интерфейсе DataOutput
Определено:: writeByte в интерфейсе ImageOutputStream
Параметры:: v - целое число, содержащее значение байта для записи.
Исключения:: IOException - если произошла ошибка ввода/вывода.

writeShort

public void writeShort(int v)
                throws IOException

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

Записывает 16 младших битов v в поток. 16 старших битов v игнорируются. Если поток использует сетевой порядок байтов, записанные байты, в порядке:

(byte)((v >> 8) & 0xff)
 (byte)(v & 0xff)

В противном случае, записанные байты будут:

(byte)(v & 0xff)
 (byte)((v >> 8) & 0xff)

Определено:: writeShort в интерфейсе DataOutput
Определено:: writeShort в интерфейсе ImageOutputStream
Параметры:: v - целое число, содержащее значение короткого целого для записи.
Исключения:: IOException - если произошла ошибка ввода/вывода.

writeChar

public void writeChar(int v)
               throws IOException

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

Этот метод является синонимом для writeShort.

Определено:: writeChar в интерфейсе DataOutput
Определено:: writeChar в интерфейсе ImageOutputStream
Параметры:: v - целое число, содержащее значение char (безусловное короткое целое) для записи.
Исключения:: IOException - если произошла ошибка ввода/вывода.
См. также:: ImageOutputStream.writeShort(int)

writeInt

public void writeInt(int v)
              throws IOException

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

Записывает 32 бита v в поток. Если поток использует сетевой порядок байтов, записанные байты, в порядке:

(byte)((v >> 24) & 0xff)
 (byte)((v >> 16) & 0xff)
 (byte)((v >> 8) & 0xff)
 (byte)(v & 0xff)

В противном случае, записанные байты будут:

(byte)(v & 0xff)
 (byte)((v >> 8) & 0xff)
 (byte)((v >> 16) & 0xff)
 (byte)((v >> 24) & 0xff)

Определено:: writeInt в интерфейсе DataOutput
Определено:: writeInt в интерфейсе ImageOutputStream
Параметры:: v - целое число, содержащее значение для записи.
Исключения:: IOException - если произошла ошибка ввода/вывода.

writeLong

public void writeLong(long v)
               throws IOException

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

Записывает 64 бита v в поток. Если поток использует сетевой порядок байтов, записанные байты, в порядке:

(byte)((v >> 56) & 0xff)
 (byte)((v >> 48) & 0xff)
 (byte)((v >> 40) & 0xff)
 (byte)((v >> 32) & 0xff)
 (byte)((v >> 24) & 0xff)
 (byte)((v >> 16) & 0xff)
 (byte)((v >> 8) & 0xff)
 (byte)(v & 0xff)

В противном случае, записанные байты будут:

(byte)(v & 0xff)
 (byte)((v >> 8) & 0xff)
 (byte)((v >> 16) & 0xff)
 (byte)((v >> 24) & 0xff)
 (byte)((v >> 32) & 0xff)
 (byte)((v >> 40) & 0xff)
 (byte)((v >> 48) & 0xff)
 (byte)((v >> 56) & 0xff)

Определено:: writeLong в интерфейсе DataOutput
Определено:: writeLong в интерфейсе ImageOutputStream
Параметры:: v - длинное целое, содержащее значение для записи.
Исключения:: IOException - если произошла ошибка ввода/вывода.

writeFloat

public void writeFloat(float v)
                throws IOException

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

Записывает значение с плавающей точкой, состоящее из четырёх байтов, в выходной поток. Это делается так, как будто сначала это значение с плавающей точкой преобразуется в целое число точно так же, как метод Float.floatToIntBits, а затем значение целого числа записывается точно так же, как метод writeInt.

Определено:: writeFloat в интерфейсе DataOutput
Определено:: writeFloat в интерфейсе ImageOutputStream
Параметры:: v - число с плавающей точкой, содержащее значение для записи.
Исключения:: IOException - если произошла ошибка ввода/вывода.

writeDouble

public void writeDouble(double v)
                 throws IOException

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

Записывает значение с двойной точностью, состоящее из восьми байтов, в выходной поток. Это делается так, как будто сначала это значение с двойной точностью преобразуется в длинное целое число точно так же, как метод Double.doubleToLongBits, а затем значение длинного целого числа записывается точно так же, как метод writeLong.

Определено:: writeDouble в интерфейсе DataOutput
Определено:: writeDouble в интерфейсе ImageOutputStream
Параметры:: v - число с двойной точностью, содержащее значение для записи.
Исключения:: IOException - если произошла ошибка ввода/вывода.

writeBytes

public void writeBytes(String s)
                throws IOException

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

Записывает строку в выходной поток. Для каждого символа в строке s, взятого по порядку, один байт записывается в выходной поток. Если s является null, выбрасывается NullPointerException.

Если s.length равно нулю, то байты не записываются. В противном случае, сначала записывается символ s[0], затем s[1], и так далее; последний записанный символ — s[s.length-1]. Для каждого символа записывается один байт, младший байт, точно так же, как в методе writeByte. Старшие восемь битов каждого символа в строке игнорируются.

Если смещение бита в потоке не равно нулю, остаток текущего байта заполняется нулями и записывается первым. Смещение бита будет равно 0 после записи.

Указано в:: writeBytes в интерфейсе DataOutput
Указано в:: writeBytes в интерфейсе ImageOutputStream
Параметры:: s - String содержащий значение для записи.
Исключения:: IOException - если возникает ошибка ввода-вывода.

writeChars

public void writeChars(String s)
                throws IOException

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

Записывает строку в выходной поток. Для каждого символа в строке s, взятого по порядку, два байта записываются в выходной поток, упорядоченные в соответствии с текущей установкой порядка байтов. Если используется порядок байтов сети, старший байт записывается первым; в противном случае порядок обратный. Если s является null, выбрасывается NullPointerException.

Указано в:: writeChars в интерфейсе DataOutput
Указано в:: writeChars в интерфейсе ImageOutputStream
Параметры:: s - String содержащий значение для записи.
Исключения:: IOException - если возникает ошибка ввода-вывода.

writeUTF

public void writeUTF(String s)
              throws IOException

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

Записывает два байта информации о длине в выходной поток в порядке байтов сети, за которыми следует представление modified UTF-8 каждого символа в строке s. Если s является null, выбрасывается NullPointerException. Каждый символ в строке s преобразуется в группу из одного, двух или трех байтов в зависимости от значения символа.

Если символ c находится в диапазоне от \u0001 до \u007f, он представляется одним байтом:

(byte)c

Если символ c является \u0000 или находится в диапазоне от \u0080 до \u07ff, то он представляется двумя байтами, которые записываются в указанном порядке:

(byte)(0xc0 | (0x1f & (c >> 6)))
 (byte)(0x80 | (0x3f & c))

Если символ c находится в диапазоне от \u0800 до uffff, то он представляется тремя байтами, которые записываются в указанном порядке:

(byte)(0xe0 | (0x0f & (c >> 12)))
 (byte)(0x80 | (0x3f & (c >> 6)))
 (byte)(0x80 | (0x3f & c))

Сначала вычисляется общее количество байтов, необходимых для представления всех символов s. Если это число больше, чем 65535, то выбрасывается UTFDataFormatException. В противном случае эта длина записывается в выходной поток точно так же, как в методе writeShort; после этого записывается одно-, двух- или трехбайтовое представление каждого символа в строке s.

Текущая настройка порядка байтов игнорируется.

Примечание: Этот метод не следует использовать при реализации форматов изображений, использующих стандартный UTF-8, поскольку модифицированный UTF-8, используемый здесь, несовместим со стандартным UTF-8.

Указано в:: writeUTF в интерфейсе DataOutput
Указано в:: writeUTF в интерфейсе ImageOutputStream
Параметры:: s - String содержащий значение для записи.
Исключения:: UTFDataFormatException - если представление modified UTF-8 s требует более 65536 байтов.; IOException - если возникает ошибка ввода-вывода.

writeShorts

public void writeShorts(short[] s,
                        int off,
                        int len)
                 throws IOException

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

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

Указано в:: writeShorts в интерфейсе ImageOutputStream
Параметры:: s - массив short для записи.; off - начальное смещение в данных.; len - количество short для записи.
Исключения:: IOException - если возникает ошибка ввода-вывода.

writeChars

public void writeChars(char[] c,
                       int off,
                       int len)
                throws IOException

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

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

Указано в:: writeChars в интерфейсе ImageOutputStream
Параметры:: c - массив char для записи.; off - начальное смещение в данных.; len - количество char для записи.
Исключения:: IOException - если возникает ошибка ввода-вывода.

writeInts

public void writeInts(int[] i,
                      int off,
                      int len)
               throws IOException

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

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

Указано в:: writeInts в интерфейсе ImageOutputStream
Параметры:: i - массив int для записи.; off - начальное смещение в данных.; len - количество int для записи.
Исключения:: IOException - если возникает ошибка ввода-вывода.

writeLongs

public void writeLongs(long[] l,
                       int off,
                       int len)
                throws IOException

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

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

Указано в:: writeLongs в интерфейсе ImageOutputStream
Параметры:: l - массив long для записи.; off - начальное смещение в данных.; len - количество long для записи.
Исключения:: IOException - если возникает ошибка ввода-вывода.

writeFloats

public void writeFloats(float[] f,
                        int off,
                        int len)
                 throws IOException

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

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

Указано в:: writeFloats в интерфейсе ImageOutputStream
Параметры:: f - массив float для записи.; off - начальное смещение в данных.; len - количество float для записи.
Исключения:: IOException - если возникает ошибка ввода-вывода.

writeDoubles

public void writeDoubles(double[] d,
                         int off,
                         int len)
                  throws IOException

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

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

Указано в:: writeDoubles в интерфейсе ImageOutputStream
Параметры:: d - массив doubles для записи.; off - начальный смещение в данных.; len - количество double для записи.
Исключения:: IOException - если произошла ошибка ввода-вывода.

writeBit

public void writeBit(int bit)
              throws IOException

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

Записывает один бит, задаваемый младшим битом аргумента, в поток по текущему битовому смещению в текущей позиции байта. Верхние 31 бит аргумента игнорируются. Указанный бит заменяет предыдущий бит в этой позиции. Битовое смещение увеличивается на единицу и уменьшается по модулю 8.

Если какие-либо биты определённого байта никогда не были установлены в момент сброса байта в место назначения, эти биты будут автоматически установлены в 0.

Указано в:: writeBit в интерфейсе ImageOutputStream
Параметры:: bit - int, младший бит которого должен быть записан в поток.
Исключения:: IOException - если произошла ошибка ввода-вывода.

writeBits

public void writeBits(long bits,
                      int numBits)
               throws IOException

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

Записывает последовательность битов, задаваемую numBits младшими битами аргумента bits в порядке слева направо, в поток по текущему битовому смещению в текущей позиции байта. Верхние 64 - numBits биты аргумента игнорируются. Битовое смещение увеличивается на numBits и уменьшается по модулю 8. Обратите внимание, что битовое смещение 0 всегда указывает на старший бит байта, и байты битов записываются последовательно по мере их появления. Таким образом, запись битов всегда выполняется в сетевом порядке байтов. Действительная настройка порядка байтов потока игнорируется.

Данные битов могут накапливаться в памяти неограниченно, пока не будет вызван метод flushBefore. В этот момент все данные битов до очищенной позиции будут записаны.

Указано в:: writeBits в интерфейсе ImageOutputStream
Параметры:: bits - long, содержащий биты для записи, начиная со старшего бита до младшего бита.; numBits - int от 0 до 64 включительно.
Исключения:: IOException - если произошла ошибка ввода-вывода.

flushBits

protected final void flushBits()
                        throws IOException

Если битовое смещение не равно нулю, принудительно устанавливает оставшиеся биты в текущем байте в 0 и увеличивает позицию потока на единицу. Этот метод должен вызываться подклассами в начале методов write(int) и write(byte[], int, int).

Исключения:: IOException - если произошла ошибка ввода-вывода.

© 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.