Dominando la Clase Reader de Java: Subclases, Métodos y Ejemplo Práctico

Clase Reader de Java

Esta guía te lleva a través de la clase Reader de Java, sus subclases clave, métodos esenciales y un ejemplo paso a paso usando FileReader.

¿Qué es la Clase Reader?

La clase Reader en el paquete java.io es una superclase abstracta que representa un flujo de entrada de caracteres. Aunque no puede instanciarse directamente, sus subclases concretas proporcionan la funcionalidad necesaria para leer datos de texto de diversas fuentes.

Subclases Comunes de Reader

• BufferedReader – Añade búfer para lectura eficiente de caracteres, arrays y líneas.
• InputStreamReader – Puente entre flujos de bytes y flujos de caracteres usando un charset especificado.
• FileReader – Clase de conveniencia para leer archivos codificados en el charset por defecto.
• StringReader – Lee caracteres de una cadena como un flujo.

Profundizaremos en cada subclase en tutoriales dedicados.

Instanciar un Reader

Para crear un reader concreto, importa java.io.Reader y una de sus subclases. Por ejemplo, usando FileReader:

import java.io.Reader;
import java.io.FileReader;
Reader entrada = new FileReader("input.txt");

Como Reader es abstracta, debes usar una subclase; de lo contrario, ocurre un error en tiempo de compilación.

Consejo: Puedes instanciar cualquiera de las otras subclases de la misma manera.

Métodos Principales Proporcionados por Reader

• boolean ready() – Retorna true si el flujo está listo para leerse sin bloqueo.
• int read(char[] cbuf) – Lee caracteres en un array y retorna el número leído.
• int read(char[] cbuf, int off, int len) – Lee hasta len caracteres en cbuf comenzando en off.
• void mark(int readAheadLimit) – Marca la posición actual en el flujo.
• void reset() – Reposiciona el flujo a la última posición marcada.
• long skip(long n) – Salta y descarta n caracteres.

Ejemplo: Leyendo un Archivo con FileReader

Supongamos que tenemos un archivo llamado input.txt que contiene:

Esta es una línea de texto dentro del archivo.

A continuación se muestra un ejemplo completo, listo para producción, que lee el archivo e imprime su contenido:

import java.io.FileReader;
import java.io.IOException;
import java.io.Reader;

public class Main {
    public static void main(String[] args) {
        // Asignar un búfer lo suficientemente grande para el contenido esperado
        char[] buffer = new char[100];
        // Usar try-with-resources para asegurar que el reader se cierre automáticamente
        try (Reader reader = new FileReader("input.txt")) {
            System.out.println("¿Hay datos en el flujo? " + reader.ready());
            int charsLeidos = reader.read(buffer);
            System.out.println("Datos en el flujo:\n" + new String(buffer, 0, charsLeidos));
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

Salida

¿Hay datos en el flujo? true
Datos en el flujo:
Esta es una línea de texto dentro del archivo.

Conclusiones clave:

• Siempre cierra el reader—try-with-resources lo maneja automáticamente.
• Usa ready() para verificar que hay datos disponibles antes de intentar leer.
• Maneja IOException para cubrir escenarios de archivo no encontrado o error de lectura.

Para documentación más detallada, visita el Javadoc oficial de Java Reader.

¡Feliz codificación!