Java InputStreamReader解説：メソッド、エンコーディング、実践例

Java InputStreamReader解説

JavaのInputStreamReaderがバイトストリームを文字ストリームに橋渡しする仕組み、コアメソッド、エンコーディングの正しい扱い方を解説します。

java.ioのInputStreamReaderクラスは、生バイトを文字に変換し、テキストファイル、ネットワークストリーム、文字を表す任意のバイトベースソースの読み取りに不可欠です。

抽象Readerクラスを拡張し、バイトストリーム（例：FileInputStream）と文字ストリームの間の橋渡し役を果たします。

文字が複数バイトを必要とする場合（UTF-8やUTF-16エンコードテキストなど）、InputStreamReaderはそれらのバイトを一緒に読み取り正しい文字を生成します。

---

InputStreamReaderの作成

必要なクラスをインポート：

import java.io.InputStreamReader;

典型的なインスタンス化では、基盤バイトソースとしてFileInputStreamを使用：

FileInputStream file = new FileInputStream("example.txt");
InputStreamReader reader = new InputStreamReader(file);

ファイルのエンコーディングがわかっている場合は、誤解釈を避けるために指定：

InputStreamReader reader = new InputStreamReader(file, Charset.forName("UTF-8"));

Charsetを使用すると、リーダーが意図した文字セットでバイトを解釈することを保証します。

---

InputStreamReaderのコアメソッド

read()

• int read() – 1文字読み取り
• int read(char[] cbuf) – 配列に文字を格納
• int read(char[] cbuf, int off, int len) – 最大len文字をcbufのoffから読み取り

例：テキストファイルを文字配列に読み取り

import java.io.*;

class Main {
    public static void main(String[] args) {
        char[] buffer = new char[100];
        try (FileInputStream file = new FileInputStream("input.txt");
             InputStreamReader reader = new InputStreamReader(file)) {
            reader.read(buffer);
            System.out.println("ストリーム内のデータ:\n" + new String(buffer));
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

出力

ストリーム内のデータ:
This is a line of text inside the file.

---

getEncoding()

リーダーが使用するエンコーディングを取得：

InputStreamReader defaultReader = new InputStreamReader(file);
InputStreamReader utf8Reader = new InputStreamReader(file, Charset.forName("UTF-8"));
System.out.println("デフォルトエンコーディング: " + defaultReader.getEncoding());
System.out.println("UTF-8エンコーディング: " + utf8Reader.getEncoding());

出力

デフォルトエンコーディング: Cp1252
UTF-8エンコーディング: UTF-8

エンコーディング未指定時、getEncoding()はプラットフォームのデフォルトcharsetを返します。

注意: 明示的なエンコーディングにはCharset.forName()を使用。詳細はJava Charsetドキュメントを参照。

---

close()

使用後は常にリーダーを閉じます。上記のtry-with-resources構文が自動的に処理しますが、reader.close()を明示的に呼ぶことも可能です。

---

その他の便利なメソッド

メソッド	説明
ready()	ストリームが読み取り準備完了かチェック
mark(int readAheadLimit)	現在位置をマークして後でリセット可能に
reset()	最後にマークした位置に戻る

包括的なリファレンスは公式InputStreamReaderページを参照。