`Files.readString` în Java

Citește tot conținutul unui fișier text într-un singur String (implicit în UTF-8).

Sintaxă

static String readString(Path cale) throws IOException
static String readString(Path cale, Charset codare) throws IOException

Ce face `Files.readString`

Files.readString(cale) deschide fișierul, citește tot textul, îl închide și returnează un String. Este cea mai simplă metodă pentru fișiere mici și medii: configurări, șabloane, fișiere CSV scurte.

Implicit textul se citește ca UTF-8. Dacă fișierul are altă codare (de exemplu Windows-1250, folosită de programe vechi românești), dai al doilea argument: Charset.forName("windows-1250"). Dacă octeții nu sunt UTF-8 valid, metoda aruncă MalformedInputException.

Tot fișierul ajunge în memorie. Pentru fișiere foarte mari, citește-l rând cu rând cu Files.lines sau BufferedReader.

Parametri

Parametru	Descriere
`cale`	Calea fișierului.
`codare`	Opțional: setul de caractere, implicit `StandardCharsets.UTF_8`.

Ce returnează

Conținutul fișierului ca String, cu tot cu sfârșiturile de rând.

Exemple

Exemplul 1: Citirea unui fișier cu diacritice

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;

public class Main {
    public static void main(String[] args) throws IOException {
        Path cale = Path.of("poezie.txt");
        Files.writeString(cale, "Pe lângă plopii fără soț\nAdesea am trecut;\n");

        String text = Files.readString(cale);
        System.out.print(text);
        System.out.println("Caractere: " + text.length());
        System.out.println("Rânduri: " + text.lines().count());
    }
}

Rezultat

Pe lângă plopii fără soț
Adesea am trecut;
Caractere: 43
Rânduri: 2

Exemplul 2: Configurare simplă din fișier

Citim tot textul, apoi îl împărțim în rânduri de forma cheie=valoare.

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;

public class Main {
    public static void main(String[] args) throws IOException {
        Path cale = Path.of("setari.txt");
        Files.writeString(cale, "oras=Cluj-Napoca\nlimba=ro\nmoneda=RON\n");

        for (String rand : Files.readString(cale).split("\n")) {
            String[] parti = rand.split("=", 2);
            System.out.println(parti[0] + " -> " + parti[1]);
        }
    }
}