Класс 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()

Читает следующий байт данных из этого входного потока. Значение байта возвращается как целое число в диапазоне от 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 метки/сброс. Метод markSupported класса ByteArrayInputStream всегда возвращает true.

public void mark(int readAheadLimit)

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

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

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

public void reset()

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

public void close() throws IOException

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