Java Readerクラス完全ガイド：サブクラス、メソッド、FileReader実例

Java Readerクラス

JavaのReaderクラス、その主要サブクラス、必須メソッド、FileReaderを使用したステップバイステップ例を解説します。

Readerクラスとは？

java.ioパッケージのReaderクラスは、文字入力ストリームを表す抽象スーパークラスです。直接インスタンス化できませんが、その具象サブクラスがさまざまなソースからテキストデータを読み取る機能を提供します。

---

Readerの一般的なサブクラス

• BufferedReader – 文字、配列、行の効率的な読み取りのためにバッファリングを追加
• InputStreamReader – 指定charsetを使用してバイトストリームを文字ストリームに橋渡し
• FileReader – デフォルトcharsetでエンコードされたファイル読み取りの便利クラス
• StringReader – 文字列から文字をストリームとして読み取り

各サブクラスは専用チュートリアルで深掘りします。

---

Readerのインスタンス化

具象リーダーを作成するには、java.io.Readerとそのサブクラスのいずれかをインポート。例えばFileReaderを使用：

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

Reader input = new FileReader("input.txt");

Readerは抽象クラスなので、サブクラスを使用する必要があります。そうでないとコンパイルエラーになります。

ヒント: 他のサブクラスも同様の方法でインスタンス化できます。

---

Readerが提供する主要メソッド

• boolean ready() – ブロックせずに読み取り可能ならtrueを返す
• int read(char[] cbuf) – 文字を配列に読み取り、読み取った数を返す
• int read(char[] cbuf, int off, int len) – 最大len文字をcbufのoffから読み取り
• void mark(int readAheadLimit) – ストリームの現在位置をマーク
• void reset() – ストリームを最後にマークした位置に再配置
• long skip(long n) – n文字をスキップして破棄

---

例：FileReaderでファイル読み取り

input.txtに以下の内容があると仮定：

This is a line of text inside the file.

ファイルを読み取り内容を出力する完全で本番対応の例：

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

public class Main {
    public static void main(String[] args) {
        // 期待コンテンツに十分な大きさのバッファを割り当て
        char[] buffer = new char[100];
        
        // try-with-resourcesでリーダーを自動的にクローズ
        try (Reader reader = new FileReader("input.txt")) {
            System.out.println("ストリームにデータがありますか？ " + reader.ready());
            int charsRead = reader.read(buffer);
            System.out.println("ストリーム内のデータ:\n" + new String(buffer, 0, charsRead));
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

出力

ストリームにデータがありますか？ true
ストリーム内のデータ:
This is a line of text inside the file.

重要ポイント：

• リーダーは常に閉じる – try-with-resourcesが自動処理
• 読み取り前にready()でデータ可用性を確認
• IOExceptionをハンドリングしてファイル未検出や読み取りエラーに対応

詳細ドキュメントは公式Java Reader Javadocを参照。

---

Happy coding!