在 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 关闭时被关闭。