Класс ByteArrayInputStream

protected byte[] buf

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

protected int pos

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

protected int mark

Текущая отмеченная позиция в потоке. При создании объектов ByteArrayInputStream по умолчанию отмечается позиция 0. Эту позицию можно изменить на другую позицию в буфере с помощью метода 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. С помощью этого метода отметку можно установить на другую позицию в буфере.

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

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

public void reset()

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

public void close() throws IOException

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