Course contentsShow
← Java
Lesson 2046 of 2,87041. NIO.2 and the Path APIFree lesson

Files.readString: Reading Files as Single Strings (Java 11+)

Use Files.readString to load an entire file's contents into one String, simplifying text file reading.

Files.readString: Reading Files as Single Strings (Java 11+)

You'll learn how to load an entire text file into a single String object with one simple method call.

The Core Idea

Before Java 11, reading a text file into a single String required multiple steps—creating a BufferedReader, accumulating lines, joining them with newline characters. Files.readString() eliminates this boilerplate by doing everything in one method call. It reads the entire file, handles encoding, and returns the complete contents as a single String.

Think of it like ordering a fully assembled bookshelf instead of receiving pieces and instructions—you get exactly what you need, ready to use.

How It Works

The method signature is straightforward:

String content = Files.readString(path);

You can also specify an encoding:

String content = Files.readString(path, StandardCharsets.UTF_8);

The method reads all bytes from the file, decodes them using the specified charset (or UTF-8 by default), and returns the result as a single String.

When to Use It

Use Files.readString() when:

  • You need the entire file contents as one String
  • The file is small enough to fit comfortably in memory
  • You want simple, readable code without manual resource management

For large files or line-by-line processing, stick with Files.lines() or newBufferedReader() to avoid memory issues.

Example Usage

Path configPath = Paths.get("config.txt");
String config = Files.readString(configPath);
// Now 'config' contains the entire file—newlines and all

Key Takeaway: Files.readString() is the simplest way to load small text files into a single String, handling encoding and resource management automatically—but only use it when the entire file fits comfortably in memory.