Класс 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 байтов, позволяет внешнему коду сбросить поток и попробовать другой парсер.