Класс ByteArrayInputStream

protected byte[] buf

Массив байтов, предоставленный создателем потока. Элементы buf[0] по buf[count-1] — это единственные байты, которые можно прочитать из потока; элемент buf[pos] — это следующий байт для чтения.

protected int pos

Индекс следующего байта для чтения из буфера входного потока. Это значение должно всегда быть неотрицательным и не превышать значение count. Следующий байт для чтения из буфера входного потока будет buf[pos].

protected int mark

Текущая помеченная позиция в потоке. Объекты ByteArrayInputStream по умолчанию помечаются в позиции ноль при создании. Их можно пометить в другой позиции в буфере с помощью метода mark(). Текущая позиция буфера устанавливается в эту точку методом reset().

Если метка не была установлена, то значение mark равно смещению, переданному в конструктор (или 0, если смещение не было передано).

protected int count

Индекс, на единицу больший, чем последний допустимый байт в буфере входного потока. Это значение должно всегда быть неотрицательным и не превышать длину buf. Оно на единицу больше позиции последнего байта в buf, который можно прочитать из буфера входного потока.

public ByteArrayInputStream(byte[] buf)

Создаёт ByteArrayInputStream, используя buf в качестве массива буфера. Массив буфера не копируется. Начальное значение pos равно 0, а начальное значение count равно длине buf.

public ByteArrayInputStream(byte[] buf, int offset, int length)

Создаёт ByteArrayInputStream, используя buf в качестве массива буфера. Начальное значение pos равно offset, а начальное значение count равно минимуму из offset+length и buf.length. Массив буфера не копируется. Метка буфера устанавливается в указанное смещение.

public int read()

Читает следующий байт данных из этого входного потока. Возвращаемое значение байта — это int в диапазоне от 0 до 255. Если байт недоступен из-за достижения конца потока, возвращается значение -1.

Этот метод read не может блокировать.

public int read(byte[] b, int off, int len)

Читает до len байтов данных в массив байтов из этого входного потока. Если pos равно count, то возвращается -1, чтобы указать конец файла. В противном случае, количество k прочитанных байтов равно меньшему из len и count-pos. Если k положительно, то байты buf[pos] по buf[pos+k-1] копируются в b[off] по b[off+k-1] так, как это выполняется методом System.arraycopy. Значение k добавляется к pos, и возвращается k.

В отличие от метода overridden method класса InputStream, этот метод возвращает -1 вместо нуля, если достигнут конец потока и len == 0.

Этот метод read не может блокировать.

public byte[] readAllBytes()

Читает все оставшиеся байты из входного потока. Этот метод блокируется до тех пор, пока все оставшиеся байты не будут прочитаны и не будет обнаружен конец потока, или не будет выброшено исключение. Этот метод не закрывает входной поток.

Когда этот поток достигает конца потока, дальнейшие вызовы этого метода вернут пустой массив байтов.

Обратите внимание, что этот метод предназначен для простых случаев, когда удобно прочитать все байты в массив байтов. Он не предназначен для чтения входных потоков с большими объёмами данных.

Поведение в случае, когда входной поток асинхронно закрывается, или поток прерывается во время чтения, сильно зависит от конкретного входного потока и поэтому не определено.

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

public int readNBytes(byte[] b, int off, int len)

Читает запрошенное количество байтов из входного потока в заданный массив байтов. Этот метод блокируется до тех пор, пока не будет прочитано len байтов входных данных, не будет обнаружен конец потока или не будет выброшено исключение. Возвращается количество фактически прочитанных байтов, возможно ноль. Этот метод не закрывает входной поток.

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

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

Первый прочитанный байт сохраняется в элементе b[off], следующий — в b[off+1] и так далее. Количество прочитанных байтов, как максимум, равно len. Пусть k — количество фактически прочитанных байтов; эти байты будут сохранены в элементах b[off] по b[off+k-1], оставляя элементы b[off+k ] по b[off+len-1] неизменёнными.

Поведение в случае, когда входной поток асинхронно закрывается, или поток прерывается во время чтения, сильно зависит от конкретного входного потока и поэтому не определено.

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

public long skip(long n)

Пропускает n байтов входных данных из этого входного потока. Может быть пропущено меньше байтов, если достигнут конец входного потока. Фактическое количество k пропусков равно меньшему из n и count-pos. Значение k добавляется к pos, и возвращается k.

public int available()

Возвращает количество оставшихся байтов, которые можно прочитать (или пропустить) из этого потока ввода.

Возвращаемое значение равно count - pos, что представляет количество байтов, оставшихся для чтения из буфера ввода.

public boolean markSupported()

Проверяет, поддерживает ли этот InputStream функцию mark/reset.

public void mark(int readAheadLimit)

Устанавливает текущую отмеченную позицию в потоке. Объекты ByteArrayInputStream по умолчанию отмечаются в позиции ноль при создании. Они могут быть помечены в другой позиции внутри буфера с помощью этого метода.

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

Примечание: Значение readAheadLimit для этого класса не имеет смысла.

public void reset()

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

public void close() throws IOException

Закрытие ByteArrayInputStream не оказывает никакого влияния. Методы в этом классе могут быть вызваны после закрытия потока без генерации IOException.