Dominando Java PrintWriter: Características, Métodos y Ejemplos Prácticos

Dominando Java PrintWriter

En este tutorial exploramos la clase PrintWriter de Java, sus métodos de impresión y ejemplos de código prácticos.

La clase PrintWriter, parte de java.io, está diseñada para escribir datos de caracteres en archivos de texto u otros flujos de salida. Extiende Writer y ofrece métodos de formateo convenientes.

A diferencia de otros writers, PrintWriter convierte automáticamente tipos primitivos (int, float, char, etc.) a texto antes de escribir. Tampoco lanza IOException; en su lugar, puedes detectar errores con checkError().

Auto-flush es una característica clave: si está habilitado, cada llamada a println() o printf() fuerza el búfer a vaciarse al flujo subyacente.

Cómo Funciona PrintWriter

PrintWriter escribe texto formateado en un Writer o OutputStream subyacente. Su constructor acepta una bandera autoFlush y, opcionalmente, un Charset para codificación.

Crear un PrintWriter

Primero, importa la clase:

import java.io.PrintWriter;

1. Desde un `Writer` existente

FileWriter archivo = new FileWriter("output.txt");
PrintWriter salida = new PrintWriter(archivo, true); // autoFlush = true

2. Desde un `OutputStream`

FileOutputStream fos = new FileOutputStream("output.txt");
PrintWriter salida = new PrintWriter(fos, true);

3. Directamente desde un nombre de archivo

PrintWriter salida = new PrintWriter("output.txt", true);

4. Especificando codificación de caracteres

import java.nio.charset.Charset;
PrintWriter salida = new PrintWriter("output.txt", true, Charset.forName("UTF-8"));

Usar un Charset asegura que tu texto se escriba con la codificación deseada.

Métodos Principales

print() y println()

Estos métodos escriben texto sin formato o con terminación de línea:

print(obj) – escribe la representación en cadena de obj sin nueva línea.
println(obj) – escribe la cadena y añade el separador de línea del sistema.

printf()

La familia printf soporta la sintaxis Formatter de Java. Ejemplo:

salida.printf("Tengo %d años.", 25);

Otros métodos útiles

Método	Descripción
`close()`	Cierra el flujo y libera recursos.
`checkError()`	Retorna `true` si ha ocurrido un error de escritura.
`append(CharSequence)`	Añade la secuencia dada al writer.

Ejemplo Práctico

A continuación se muestra un programa completo y ejecutable que escribe texto formateado en output.txt usando printf():

import java.io.PrintWriter;
import java.io.FileWriter;
import java.io.IOException;

public class PrintWriterDemo {
    public static void main(String[] args) {
        try (PrintWriter salida = new PrintWriter(new FileWriter("output.txt"), true)) {
            int edad = 25;
            salida.printf("Tengo %d años.\n", edad);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

Ejecutar este programa crea output.txt con la línea: