在 Java 的 I/O 体系中,java.io.LineNumberReader 类是一种特殊的 BufferedReader,它继承自 BufferedReader,其主要功能是跟踪读取字符时的行号。
当 LineNumberReader 对封装的 Reader 所返回的字符进行处理时,一旦检测到行结束符,行号就会自动递增。这一特性使得在处理文本文件或字符流时,能够方便地记录和定位每一行的位置。
若你想知晓当前读取到哪一行,可以调用 LineNumberReader 的 getLineNumber() 方法,它会返回当前的行号。此外,若有特殊需求,你还能通过调用 setLineNumber() 方法手动设置当前的行号,以满足特定的业务逻辑或调试需求。
以下是一个简单的 LineNumberReader示例:
package com.hxstrive.java_io; import java.io.FileReader; import java.io.LineNumberReader; public class LineNumberReaderExample { public static void main(String[] args) throws Exception { try(LineNumberReader lineNumberReader = new LineNumberReader(new FileReader("input.txt"))) { int data = lineNumberReader.read(); while(data != -1){ char dataChar = (char) data; data = lineNumberReader.read(); // 读取一个字符 int lineNumber = lineNumberReader.getLineNumber(); // 读取行号 System.out.println("lineNumber=" + lineNumber + ", dataChar=" + dataChar); } } } }
输出结果:
lineNumber=0, dataChar=你 lineNumber=0, dataChar=好 lineNumber=1, dataChar=! lineNumber=1, dataChar= lineNumber=1, dataChar=J lineNumber=1, dataChar=a lineNumber=1, dataChar=v lineNumber=1, dataChar=a lineNumber=1, dataChar=世 lineNumber=1, dataChar=界
上述示例,首先创建了一个 LineNumberReader,然后演示了如何从中读取所有字符,还演示了如何获取行号。
如果你正在解析一个可能包含错误的文本文件(如程序日志文件),行号会非常方便。在向用户报告错误时,如果错误信息中包含出现错误的行号,就更容易纠正错误。
当你完成从 LineNumberReader 读取字符后,必须记得关闭它。关闭 LineNumberReader 也会关闭读取 LineNumberReader 的底层 Reader 实例。
关闭 LineNumberReader 仅需要调用其 close() 方法。下面是关闭 LineNumberReader 的过程:
lineNumberReader.close();
你还可以使用 Java7 中引入的 try-with-resources 结构,自动调用 close()。以下是如何使用 try-with-resources 结构关闭 LineNumberReader:
Reader reader = new FileReader("input.txt"); try(LineNumberReader lineNumberReader = new LineNumberReader(reader)){ String line = lineNumberReader.readLine(); while(line != null) { System.out.println(line); line = lineNumberReader.readLine(); } }
注意,上面示例,FileReader 实例并没有在 try-with-resources 代码块中创建。这意味着 try-with-resources 块不会自动关闭 FileReader 实例。不过,当 LineNumberReader 关闭时,它也会关闭它所读取的 Reader 实例,因此 FileReader 实例会在 LineNumberReader 关闭时被关闭。