本文详细介绍了如何在Java中设计一个FileStats类，用于统计文件的总行数以及包含特定关键词（不区分大小写）的行数。教程着重讲解了文件读取的核心机制，特别是scanner类的正确初始化与使用，纠正了将文件名字符串误用作输入源的常见错误，并提供了利用try-with-resources语句进行资源管理的代码示例，以提升程序的健壮性与可维护性。
1. FileStats 类设计与功能概述
在Java中进行文件处理时，通常会创建一个专门的类来封装相关的操作逻辑。FileStats 类旨在提供以下核心功能：
- 统计指定文件的总行数。
- 统计文件中包含特定文本（关键词）的行数，并且查找过程不区分大小写。
该类的基本结构包含一个用于存储文件路径的私有字段 filename，一个用于初始化该字段的构造方法，以及两个核心功能方法。
类骨架：
import java.io.File; import java.io.FileNotFoundException; import java.util.Scanner; public class FileStats { private String filename; // 存储文件路径 /** * 构造方法，初始化FileStats对象，指定要处理的文件名。 * @param f 文件路径字符串 */ public FileStats(String f) { this.filename = f; } // 后续方法将在此处添加 }
2. 实现文件总行数统计 (getNumLines)
统计文件的总行数是文件处理中的一个基本操作。其核心思想是逐行读取文件内容，并对读取到的每一行进行计数。
立即学习“Java免费学习笔记（深入）”；
实现步骤：
- 创建一个 File 对象，它代表了文件系统中的一个具体文件。
- 使用 Scanner 类来读取这个 File 对象的内容。
- 通过 Scanner.hasNextLine() 方法判断文件是否还有下一行可读。
- 通过 Scanner.nextLine() 方法读取当前行内容，并递增行数计数器。
- 重要提示： 文件读取完成后，必须关闭 Scanner 资源以释放文件句柄，防止资源泄露。在Java 7及更高版本中，推荐使用 try-with-resources 语句来自动管理资源的关闭。
代码示例：
// ... FileStats class definition ... /** * 获取文件的总行数。 * @return 文件的总行数 * @throws FileNotFoundException 如果指定的文件不存在，则抛出此异常 */ public int getNumLines() throws FileNotFoundException { File fileObj = new File(filename); // 创建File对象 int numLines = 0; // 使用try-with-resources确保Scanner自动关闭 try (Scanner inputFile = new Scanner(fileObj)) { while (inputFile.hasNextLine()) { // 判断是否还有下一行 inputFile.nextLine(); // 读取行内容，但不使用 numLines++; // 计数 } } // Scanner在此处自动关闭 return numLines; } // ...
3. 实现包含关键词的行数统计 (getNumLinesThatContain)
此方法旨在统计文件中包含特定关键词的行数。在实现过程中，一个非常常见的错误是 Scanner 的初始化方式，这直接影响了文件内容的正确读取。
核心问题与修正：Scanner 的正确初始化
在文件处理中，一个常见的陷阱是将文件路径字符串直接传递给 Scanner 构造函数，例如：
// 错误示例：将字符串本身作为Scanner的输入源 Scanner inputFile = new Scanner(filename);
这种写法会导致 Scanner 将传入的字符串 filename（例如 “my_document.txt”）本身作为要扫描的文本内容，而不是将其解释为文件路径并打开文件。因此，Scanner 会尝试从字符串字面量 “my_document.txt” 中读取数据，而不是从磁盘上的实际文件中读取，这通常会导致 hasNext() 或 hasNextLine() 立即返回 false，或者只处理该字符串本身的简短内容，从而无法正确读取文件。
正确的做法是，Scanner 必须从一个 File 对象中读取数据：
// 正确示例：从File对象中读取文件内容 File fileObj = new File(filename); Scanner inputFile = new Scanner(fileObj);
这样，Scanner 才能正确地识别并打开指定路径的文件，并从中读取内容。
实现步骤：
- 同样，先创建一个 File 对象。
- 使用 Scanner 正确地读取 File 对象的内容。
- 逐行读取文件。
- 为了实现不区分大小写的查找，将当前读取的行内容和要查找的关键词都转换为大写（或小写）。
- 使用 String.contains() 方法检查转换后的行是否包含转换后的关键词。
- 如果包含，则递增计数器。
- 继续使用 try-with-resources 确保 Scanner 资源被正确关闭。
代码示例：
// ... FileStats class definition ... /** * 获取文件中包含特定关键词的行数（不区分大小写）。 * @param key 要查找的关键词 * @return 包含关键词的行数 * @throws FileNotFoundException 如果指定的文件不存在，则抛出此异常 */ public int getNumLinesThatContain(String key) throws FileNotFoundException { File fileObj = new File(filename); // 创建File对象 int numLines = 0; // 使用try-with-resources确保Scanner自动关闭 try (Scanner inputFile = new Scanner(fileObj)) { // 将关键词提前转换为大写，避免在循环内部重复转换，提高性能 String upperCaseKey = key.toUpperCase(); while (inputFile.hasNextLine()) { String line = inputFile.nextLine(); // 将行内容转换为大写后进行包含判断 if (line.toUpperCase().contains(upperCaseKey)) { numLines++; } } } // Scanner在此处自动关闭 return numLines; } // ...
4. 完整 FileStats 类示例与最佳实践
为了确保代码的健壮性和可维护性，我们强烈推荐在所有涉及文件I/O的操作中使用 try-with-resources 语句。这可以保证无论代码块是否正常执行完毕，或者是否发生异常，像 Scanner 这样的可关闭资源都能被自动且安全地关闭，从而有效避免资源泄露。
完整的 FileStats 类代码：
import java.io.File; import java.io.FileNotFoundException; import java.util.Scanner; public class FileStats { private String filename; public FileStats(String f) { this.filename = f; } /** * 获取文件的总行数。 * @return 文件的总行数 * @throws FileNotFoundException 如果指定的文件不存在 */ public int getNumLines() throws FileNotFoundException { File fileObj = new File(filename); int numLines = 0; try (Scanner inputFile = new Scanner(fileObj)) { while (inputFile.hasNextLine()) { inputFile.nextLine(); numLines++; } } return numLines; } /** * 获取文件中包含特定关键词的行数（不区分大小写）。 * @param key 要查找的关键词 * @return 包含关键词的行数 * @throws FileNotFoundException 如果指定的文件不存在 */ public int getNumLinesThatContain(String key) throws FileNotFoundException { File fileObj = new File(filename); int numLines = 0; try (Scanner inputFile = new Scanner(fileObj)) { String upperCaseKey = key.toUpperCase(); // 提前转换关键词为大写 while (inputFile.hasNextLine()) { String line = inputFile.nextLine(); if (line.toUpperCase().contains(upperCaseKey)) { numLines++; } } } return numLines; } /** * 示例主方法，展示如何使用FileStats类。 * 请确保您的项目目录下有一个名为 "test.txt" 的文件，并包含一些文本内容。 * 示例 test.txt 内容： * Hello World * hello java programming * JAVA is powerful * Programming is fun */ public static void main(String[] args) { String testFileName = "test.txt"; // 假设存在此文件 try { FileStats stats = new FileStats(testFileName); // 统计总行数 int totalLines = stats.getNumLines(); System.out.println("文件 '" + testFileName + "' 总行数: " + totalLines); // 统计包含 "java" 的行数（不区分大小写） int javaLines = stats.getNumLinesThatContain("java"); System.out.println("包含 'java' 的行数: " + javaLines); // 统计包含 "World" 的行数 int worldLines = stats.getNumLinesThatContain("World"); System.out.println("包含 'World' 的行数: " + worldLines); // 统计包含 "nonexistent" 的行数 int nonexistentLines = stats.getNumLinesThatContain("nonexistent"); System.out.println("包含 'nonexistent' 的行数: "
© 版权声明
文章版权归作者所有，未经允许请勿转载。
THE END
