Класс LineNumberInputStream

public LineNumberInputStream(InputStream in)

Создаёт входной поток с нумерацией строк, считывающий данные из указанного входного потока.

public int read() throws IOException

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

Метод read класса LineNumberInputStream вызывает метод read базового входного потока. Он проверяет наличие в данных символов возврата каретки и символов новой строки и соответствующим образом изменяет текущий номер строки. Символ возврата каретки или последовательность из символа возврата каретки и символа новой строки преобразуются в один символ новой строки.

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

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

Метод read класса LineNumberInputStream многократно вызывает метод read без аргументов, чтобы заполнить массив байтов.

public long skip(long n) throws IOException

Пропускает и отбрасывает n байтов данных из этого входного потока. По разным причинам метод skip может пропустить меньшее количество байтов, возможно, 0. Возвращается фактическое количество пропущенных байтов. Если n отрицательно, байты не пропускаются.

Метод skip класса LineNumberInputStream создаёт массив байтов, а затем многократно считывает в него данные, пока не будут прочитаны n байтов или не будет достигнут конец потока.

public void setLineNumber(int lineNumber)

Устанавливает номер строки, указанный в аргументе.

public int getLineNumber()

Возвращает текущий номер строки.

public int available() throws IOException

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

Обратите внимание: если базовый входной поток может предоставить без блокировки k входных символов, LineNumberInputStream может гарантировать предоставление без блокировки только k/2 символов, поскольку k символов из базового входного потока могут состоять из k/2 пар '\r' и '\n', которые преобразуются всего в k/2 символов '\n'.

public void mark(int readlimit)

Помечает текущую позицию в этом входном потоке. Последующий вызов метода reset перемещает поток в последнюю помеченную позицию, чтобы при последующем чтении повторно считывались те же байты.

Метод mark класса LineNumberInputStream сохраняет текущий номер строки в закрытой переменной, а затем вызывает метод mark базового входного потока.

public void reset() throws IOException

Перемещает этот поток в позицию, в которой он находился в момент последнего вызова метода mark для этого входного потока.

Метод reset класса LineNumberInputStream сбрасывает номер строки до значения, которое было в момент вызова метода mark, а затем вызывает метод reset базового входного потока.

Метки потока предназначены для ситуаций, когда требуется немного прочитать данные вперёд, чтобы понять содержимое потока. Часто проще всего это сделать с помощью универсального синтаксического анализатора. Если поток имеет тип, обрабатываемый анализатором, он просто продолжает работу. Если поток имеет другой тип, анализатор должен выбросить исключение при ошибке, что, если это произойдёт в пределах readlimit байтов, позволит внешнему коду сбросить поток и попробовать другой анализатор.