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