Lectura/Escritura de ficheros de texto

La manera más sencilla de leer el contenido de un fichero de texto sería cargarlo en su totalidad en un String, usando la clase de utilidad Files y el método estático readString. Esto solo se puede hacer si el fichero es pequeño porque se carga en su totalidad en memoria:

var path = Path.of("/usr/share/dict/words.txt");
String contenido = Files.readString(path);

Características y aclaraciones:

• Solo se puede usar si el fichero es pequeño porque se carga todo el contenido en memoria así que existe el riesgo de colapso de la memoria.
• La clase de utilidad Files se encarga de abrir, leer y cerrar el fichero automáticamente.

Otra opción sería usar el método readAllLines para obtener una lista de las líneas del fichero y, así, obtener una variante en la que conoces la estructura de las líneas del fichero:

var path = Path.of("/usr/share/dict/words.txt");
List<String> lineas = Files.readAllLines(path);

Características y aclaraciones:

• Solo se puede usar si el fichero es pequeño porque se carga todo el contenido en memoria así que existe el riesgo de colapso de la memoria.
• La clase de utilidad Files se encarga de abrir, leer y cerrar el fichero automáticamente.

Si necesitas leer ficheros de texto muy grandes para evitar que la memoria colapse puedes usar esta opción en la que se usan los Stream de Java. El método lines devuelve un Stream del que podemos ir recuperando las líneas de una en una. Aquí estamos obligados a cerrar el flujo para liberar el fichero asociado:

var path = Path.of("/usr/share/dict/words.txt");
Stream<String> lineas = Files.lines(path);
// ...

lineas.close();

Características y aclaraciones:

• Es necesario cerrar de forma explícita el fichero para liberar los recursos.
• Se puede usar la estructura try-with-resources para que el cierre del fichero se haga automáticamente al salir del bloque try.

Te muestro un ejemplo completo en el que se leen las líneas de un fichero y se imprimen por pantalla:

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

public class Main {
    public static void main(String args[]) {
        if (args.length != 1) {
            System.err.println("Uso: java Main.java <ruta del fichero de texto>");
            System.exit(-1);
        }

        var path = Path.of(args[0]);
        if (Files.notExists(path) || !Files.isRegularFile(path)) {
            System.err.println(path + " no existe o no es un fichero de texto");
            System.exit(-1);
        }

        // En estas dos líneas se hace todo lo que se pide:
        try (var lineas = Files.lines(path)) {
            lineas.forEach(System.out::println);
        } catch (IOException e) {
            System.err.println("Se lanzó una excepción: " + e);
        }
    }
}

Se usa la clase de utilidad Files para obtener un objeto BufferedReader:

  var path = Path.of("/usr/share/dict/words.txt");
  try (BufferedReader reader = Files.newBufferedReader(path)) {
    String linea;
    while ((linea = reader.readLine()) != null) {
        // Procesar línea a línea de forma imperativa
    }
}

Características y aclaraciones:

• Se usa un búfer intermedio de Java que limita el número de llamadas al sistema.
• Es necesario cerrar de forma explícita el fichero para liberar los recursos o usar un try-with-resources.

Escribe el contenido indicado sustituyendo el contenido actual del fichero (modo sobreescritura):

var ruta = Path.of("archivo.txt");
String contenido = "Cualquier cadena de texto";
Files.writeString(ruta, contenido);

Por defecto:

• Si el fichero ruta existe se sobreescribirá, eliminando todo el contenido que pudiera tener.
• Si el fichero ruta no existe se crea con el contenido del String.

Si quieres añadir al final del archivo hay que especificar, como en el ejemplo de abajo:

• Tercer parámetro: qué hacer si el fichero no existe.
• Cuarto parámetro: la opción para añadir al final del archivo.

var ruta = Path.of("archivo.txt");
String contenido = "Cualquier cadena de texto";

// CREATE: si no existe el fichero lo crea
// APPEND: posicona el puntero al final del archivo para añadir
Files.writeString(ruta, contenido, StandardOpenOption.CREATE, StandardOpenOption.APPEND);

Cada elemento de la lista será una línea nueva en el fichero:

var ruta = Path.of("archivo.txt");
List<String> lineas = Arrays.asList("Primera línea", "Segunda línea", "Tercera línea");
Files.write(ruta, lineas);

Aquí, por defecto, como en el caso anterior:

• Si el fichero ruta existe se sobreescribirá, eliminando todo el contenido que pudiera tener.
• Si el fichero ruta no existe se crea con lista de String.

Si quieres abrir en modo añadir tendrás que especificarlo en el método write.

Se puede usar PrintWriter para usar el método printf que permite una salida general de forma más fácil en algunos escenarios. Aquí sí estamos obligados a cerrar de forma explícita el fichero.

Aquí si tienes que seguir el flujo tradicional: open-write-flush-close:

var ruta = Path.of("archivo.txt");
try (var writer = new PrintWriter(Files.newBufferedWriter(ruta))) {
    var nombre = "Alice";
    var edad = 20;
    writer.printf(Locale.getDefault(), "Hola, %s, el año que viene tendrás %d años!%n", nombre, edad + 1);
} catch (IOException e) {
    System.err.println("Se lanzó una excepción: " + e);
}

Aquí he usado un bloque try-with-resources para cerrar el PrintWriter necesario para que se vuelque el contenido escrito en el fichero. También se puede usar directamente el método close:

PrintWriter writer = null;
try {
    var ruta = Path.of("archivo.txt");
    writer = new PrintWriter(Files.newBufferedWriter(ruta));
    var name = "Alice";
    var age = 20;
    writer.printf(Locale.getDefault(), "Hola, %s, el año que viene tendrás %d años!%n", name, age + 1);
} catch (IOException e) {
    System.err.println("Se lanzó una excepción: " + e);
} finally {
    if (writer != null) {
        writer.close();
    }
}

Otra opción tradicional sería usar la clase BufferedWriter para escribir datos en ficheros (también tienes que cerrar el fichero de forma explícita):

try (var writer = Files.newBufferedWriter(path)) {
    var lineas = List.of("Línea 1", "Línea 2", "Línea 3", "Línea 4");
    for (String linea : lineas) {
        writer.write(linea);
        writer.newLine(); // añade salto de línea
    }
} catch (IOException e) {
    System.err.println("Se lanzó una excepción: " + e);
}