原文：http://zetcode.com/java/readtext/

在 Java 中阅读文本文件教程中，我们展示了如何在 Java 中阅读文本文件。 我们使用内置工具，包括FileReader，InputStreamReader和Scanner。 另外，我们使用 API Google Guava 库。

Google Guava 是 Java 的通用库集； 该集合也包括 IO API。

以下示例使用此文本文件。

src/resources/thermopylae.txt

  1. The Battle of Thermopylae was fought between an alliance of Greek city-states, 
  2. led by King Leonidas of Sparta, and the Persian Empire of Xerxes I over the 
  3. course of three days, during the second Persian invasion of Greece.

该文件位于src/resources/目录中。

Java FileReader类

我们可以使用以下 Java 类来读取 Java 中的文本文件。

  • java.io.FileReader
  • java.nio.file.Files
  • java.util.Scanner
  • java.io.InputStreamReader
  • com.google.common.io.Files

Java 使用FileReader读取文本文件

FileReader是用于读取字符文件的类。 它使用默认缓冲区大小从字符文件中读取文本。 从字节到字符的解码使用指定的字符集或平台的默认字符集。

注意：过去，FileReader依赖于默认平台的编码。 从 Java 11 开始，此问题已得到纠正。 现在可以显式指定编码。

com/zetcode/FileReaderEx.java

  1. package com.zetcode;
  3. import java.io.BufferedReader;
  4. import java.io.FileReader;
  5. import java.io.IOException;
  6. import java.nio.charset.StandardCharsets;
  8. public class FileReaderEx {
  10.     public static void main(String[] args) throws IOException {
  12.         var fileName = "src/resources/thermopylae.txt";
  14.         try (BufferedReader br = new BufferedReader(
  15.                 new FileReader(fileName, StandardCharsets.UTF_8))) {
  17.             var sb = new StringBuilder();
  19.             String line;
  20.             while ((line = br.readLine()) != null) {
  22.                 sb.append(line);
  23.                 sb.append(System.lineSeparator());
  24.             }
  26.             System.out.println(sb);
  27.         }
  28.     }
  29. }

该代码示例从thermopylae.txt文件读取文本。

  1. var fileName = "src/resources/thermopylae.txt";

在fileName变量中，我们存储文件的路径。

  1. try (BufferedReader br = new BufferedReader(
  2.     new FileReader(fileName, StandardCharsets.UTF_8))) {

FileReader将文件名作为第一个参数。 第二个参数是使用的字符集。 FileReader传递给BufferedReader，后者缓冲读取操作以获得更好的性能。 这是一个try-with-resources语句，可确保在语句末尾关闭资源（缓冲的读取器）。

  1. var sb = new StringBuilder();
  3. String line;
  4. while ((line = br.readLine()) != null) {
  6.     sb.append(line);
  7.     sb.append(System.lineSeparator());
  8. }
  10. System.out.println(sb);

在控制台上打印行会占用更多资源。 因此，我们使用StringBuilder构建输出字符串并在一个操作中将其打印出来。 这是一个可选的优化。 System.lineSeparator()返回系统相关的行分隔符字符串。

Java 使用Files.readAllLines读取文本文件

Files.readAllLines()方法从文件读取所有行。 此方法可确保在读取所有字节或引发异常后关闭文件。 使用指定的字符集将文件中的字节解码为字符。

请注意，此方法将整个文件读入内存。 因此，它可能不适用于非常大的文件。

com/zetcode/ReadAllLinesEx.java

  1. package com.zetcode;
  3. import java.io.IOException;
  4. import java.nio.charset.StandardCharsets;
  5. import java.nio.file.Files;
  6. import java.nio.file.Paths;
  7. import java.util.List;
  9. public class ReadAllLinesEx {
  11.     public static void main(String[] args) throws IOException {
  13.         var fileName = "src/resources/thermopylae.txt";
  15.         List<String> lines = Files.readAllLines(Paths.get(fileName),
  16.                 StandardCharsets.UTF_8);
  18.         for (String line : lines) {
  20.             System.out.println(line);
  21.         }
  22.     }
  23. }

使用Files.readAllLines()方法读取thermopylae.txt文件的内容并将其打印到控制台。

使用 Java8 流 API 读取文本文件

读取文本文件的另一种方法是使用 Java8 流 API。 Files.lines()从文件中读取所有行作为流。 使用StandardCharsets.UTF-8字符集将文件中的字节解码为字符。

com/zetcode/FilesLinesEx.java

  1. package com.zetcode;
  3. import java.io.IOException;
  4. import java.nio.file.Files;
  5. import java.nio.file.Paths;
  7. public class FilesLinesEx {
  9.     public static void main(String[] args) throws IOException {
  11.         var fileName = "src/resources/thermopylae.txt";
  13.         Files.lines(Paths.get(fileName)).forEachOrdered(System.out::println);
  14.     }
  15. }

使用Files.lines()方法读取thermopylae.txt文件的内容并将其打印到控制台。

Java 使用Scanner读取文本文件

Scanner是简单的文本扫描器，可以使用正则表达式解析原始类型和字符串。

com/zetcode/ScannerEx.java

  1. package com.zetcode;
  3. import java.io.File;
  4. import java.io.FileNotFoundException;
  5. import java.util.Scanner;
  7. public class ScannerEx {
  9.     public static void main(String[] args) throws FileNotFoundException {
  11.         var fileName = "src/resources/thermopylae.txt";
  13.         try (var scanner = new Scanner(new File(fileName))) {
  15.             while (scanner.hasNext()) {
  17.                 String line = scanner.nextLine();
  18.                 System.out.println(line);
  19.             }
  20.         }
  21.     }
  22. }

该示例使用Scanner读取文本文件。

  1. while (scanner.hasNext()) {
  3.     String line = scanner.nextLine();
  4.     System.out.println(line);
  5. }

使用nextLine()方法逐行读取文件。

Java 使用InputStreamReader读取文本文件

InputStreamReader是从字节流到字符流的桥梁。 它读取字节，并使用指定的字符集将其解码为字符。

com/zetcode/InputStreamReaderEx.java

  1. package com.zetcode;
  3. import java.io.BufferedReader;
  4. import java.io.File;
  5. import java.io.FileInputStream;
  6. import java.io.IOException;
  7. import java.io.InputStreamReader;
  8. import java.nio.charset.StandardCharsets;
  10. public class InputStreamReaderEx {
  12.     public static void main(String[] args) throws IOException {
  14.         var fileName = "src/resources/thermopylae.txt";
  16.         try (var br = new BufferedReader(new InputStreamReader(
  17.                 new FileInputStream(fileName), StandardCharsets.UTF_8))) {
  19.             String line;
  21.             while ((line = br.readLine()) != null) {
  23.                 System.out.println(line);
  24.             }
  25.         }
  26.     }
  27. }

该示例使用InputStreamReader读取文本文件。

  1. try (var br = new BufferedReader(new InputStreamReader(
  2.         new FileInputStream(fileName), StandardCharsets.UTF_8))) {

InputStreamReader是从FileInputStream创建的，它通过打开与实际文件的连接来创建输入流。 然后将InputStreamReader传递给BufferedReader，以提高效率。

Java 7 引入了更方便的 API 来与InputStreamReader一起使用。 可以使用Files.newBufferedReader创建新的缓冲InputStreamReader。

com/zetcode/InputStreamReaderEx2.java

  1. package com.zetcode;
  3. import java.io.BufferedReader;
  4. import java.io.IOException;
  5. import java.nio.charset.StandardCharsets;
  6. import java.nio.file.Files;
  7. import java.nio.file.Paths;
  9. public class InputStreamReaderEx2 {
  11.     public static void main(String[] args) throws IOException {
  13.         var fileName = "src/resources/thermopylae.txt";
  14.         var filePath = Paths.get(fileName);
  16.         try (BufferedReader br = Files.newBufferedReader(
  17.             filePath, StandardCharsets.UTF_8)) {
  19.             String line;
  21.             while ((line = br.readLine()) != null) {
  23.                 System.out.println(line);
  24.             }
  25.         }
  26.     }
  27. }

该示例使用Files.newBufferedReader()方法读取thermopylae.txt文件。

Java 使用Files.readAllBytes读取文本文件

Files.readAllBytes()方法从文件读取所有字节。 它确保在读取所有字节后关闭文件。

com/zetcode/ReadAllBytesEx.java

  1. package com.zetcode;
  3. import java.io.IOException;
  4. import java.nio.file.Files;
  5. import java.nio.file.Paths;
  7. public class ReadAllBytesEx {
  9.     public static void main(String[] args) throws IOException {
  11.         var fileName = "src/resources/thermopylae.txt";
  12.         var filePath = Paths.get(fileName);
  14.         byte[] data = Files.readAllBytes(filePath);
  15.         var content = new String(data);
  17.         System.out.println(content);
  18.     }
  19. }

该示例从文件读取所有字节，并将它们传递给String构造器。

Java 使用Files.readString读取文本

Java 11 引入了一种方便的方法，该方法允许一次性将整个文件读取为字符串。

Files.readString将文件中的所有内容读取为字符串，并使用指定的或默认的（StandardCharsets.UTF_8）字符集将字节解码为字符。 它确保在读取所有内容后关闭文件。

com/zetcode/ReadFileAsStringEx.java

  1. package com.zetcode;
  3. import java.io.IOException;
  4. import java.nio.file.Files;
  5. import java.nio.file.Paths;
  7. public class ReadFileAsStringEx {
  9.     public static void main(String[] args) throws IOException {
  11.         var fileName = "src/resources/thermopylae.txt";
  12.         var filePath = Paths.get(fileName);
  14.         var content = Files.readString(filePath);
  16.         System.out.println(content);
  17.     }
  18. }

该示例将thermopylae.txt文件的内容读取为字符串，然后将其打印到终端。

Java 使用FileChannel读取文本文件

FileChannel是用于读取，写入，映射和操作文件的通道。 文件通道的优点包括在文件的特定位置进行读写，加载文件的一部分或锁定文件的一部分。

com/zetcode/FileChannelEx.java

  1. package com.zetcode;
  3. import java.io.IOException;
  4. import java.io.RandomAccessFile;
  5. import java.nio.ByteBuffer;
  6. import java.nio.channels.FileChannel;
  8. public class FileChannelEx {
  10.     public static void main(String[] args) throws IOException {
  12.         var fileName = "src/resources/thermopylae.txt";
  14.         try (RandomAccessFile myFile = new RandomAccessFile(fileName, "rw");
  15.              FileChannel inChannel = myFile.getChannel()) {
  17.             ByteBuffer buf = ByteBuffer.allocate(48);
  19.             int bytesRead = inChannel.read(buf);
  21.             while (bytesRead != -1) {
  23.                 buf.flip();
  25.                 while (buf.hasRemaining()) {
  27.                     System.out.print((char) buf.get());
  28.                 }
  30.                 buf.clear();
  31.                 bytesRead = inChannel.read(buf);
  32.             }
  33.         }
  34.     }
  35. }

该示例使用FileChannel读取文本文件。

  1. try (RandomAccessFile myFile = new RandomAccessFile(fileName, "rw");
  2.         FileChannel inChannel = myFile.getChannel()) {

从RandomAccessFile创建一个FileChannle。

  1. ByteBuffer buf = ByteBuffer.allocate(48);
  3. int bytesRead = inChannel.read(buf);

我们分配一个缓冲区并读取初始数据。

  1. while (bytesRead != -1) {
  3.     buf.flip();
  5.     while (buf.hasRemaining()) {
  7.         System.out.print((char) buf.get());
  8.     }
  10.     buf.clear();
  11.     bytesRead = inChannel.read(buf);
  12. }

我们将数据读入缓冲区并将其写入终端。 我们使用flip()将缓冲区从读取更改为写入。

使用 Google Guava 读取文本文件

Google Guava 是一个 Java 帮助程序库，也具有 IO 工具。 如果要读取的文件很大，则以下两个 Guava 方法将消耗大量系统资源。

pom.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns="http://maven.apache.org/POM/4.0.0"
  3.             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4.             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
  5.             http://maven.apache.org/xsd/maven-4.0.0.xsd">
  6.     <modelVersion>4.0.0</modelVersion>
  8.     <groupId>com.zetcode</groupId>
  9.     <artifactId>readtextguavaex</artifactId>
  10.     <version>1.0-SNAPSHOT</version>
  12.     <properties>
  13.         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  14.         <maven.compiler.source>12</maven.compiler.source>
  15.         <maven.compiler.target>12</maven.compiler.target>
  16.     </properties>
  18.     <dependencies>
  19.         <dependency>
  20.             <groupId>com.google.guava</groupId>
  21.             <artifactId>guava</artifactId>
  22.             <version>28.0-jre</version>
  23.         </dependency>
  24.     </dependencies>
  26. </project>

这是 Maven POM 文件。

com/zetcode/ReadTextGuavaEx.java

  1. package com.zetcode;
  3. import com.google.common.base.Charsets;
  4. import com.google.common.io.Files;
  6. import java.io.File;
  7. import java.io.IOException;
  8. import java.util.List;
  10. public class ReadTextGuavaEx {
  12.     public static void main(String[] args) throws IOException {
  14.         var fileName = "src/main/resources/thermopylae.txt";
  16.         List<String> lines = Files.readLines(new File(fileName),
  17.                 Charsets.UTF_8);
  19.         var sb = new StringBuilder();
  21.         for (String line: lines) {
  23.             sb.append(line);
  24.             sb.append(System.lineSeparator());
  25.         }
  27.         System.out.println(sb);
  28.     }
  29. }

在示例中，我们使用Files.readLines()方法从文件中读取所有行。 该方法返回字符串列表。 将默认字符集指定为第二个参数。

在第二个示例中，我们使用Files.asCharSource()。

com/zetcode/ReadTextGuavaEx2.java

  1. package com.zetcode;
  3. import com.google.common.base.Charsets;
  4. import com.google.common.io.Files;
  6. import java.io.File;
  7. import java.io.IOException;
  9. public class ReadTextGuavaEx2 {
  11.     public static void main(String[] args) throws IOException {
  13.         var fileName = "src/main/resources/thermopylae.txt";
  15.         var charSource = Files.asCharSource(new File(fileName), 
  16.             Charsets.UTF_8).read();
  18.         System.out.println(charSource);
  19.     }
  20. }

Files.asCharSource()用于使用给定的字符集从给定的文件读取字符数据。 它的read()方法以字符串形式读取此源的内容。

在本文中，我们已经用 Java 的各种方式读取了文本文件。

您可能也对以下相关教程感兴趣： Java 列表目录内容， Java FileOutputStream教程，用 Java 复制文件， Java 教程，使用 Java8 的StringJoiner连接字符串 ，Java 网页读取或 Google Guava 简介。

列出所有 Java 教程。