Java 9のInputStream.readAllBytes()メソッドとは？使いどころと実装例を解説

Java 9以降では、InputStreamクラスに追加されたreadAllBytes()メソッドを使用することで、すべてのバイトデータを一括してbyte配列に読み込むことができます。このメソッドは、InputStreamオブジェクトから残りのバイトをすべて一度に読み込み、ストリームの終端が検出されるか、例外がスローされるまで処理をブロックします。

なお、readAllBytes()メソッドはInputStreamインスタンスを自動的にクローズしない点に注意が必要です。ストリームの終端に達した後に再度呼び出すと、空のbyte配列が返されます。そのため、リソースリークを防ぐためにも、try-with-resources構文との併用が推奨されます。

readAllBytes()メソッドの主な特徴

• Java 9でInputStreamクラスに追加されたメソッドである
• ストリームの終端まで全バイトを一括で読み込む
• ストリームは自動的に閉じられないため、呼び出し側で管理する必要がある
• 小規模なデータの一括読み込みには便利だが、大量のデータを扱う入力ストリームの読み込みには不向き

構文

public byte[] readAllBytes() throws IOException

このメソッドはIOExceptionをスローする可能性があるため、適切な例外処理が必須です。

使用例

以下の例では、「C:\Temp」フォルダ内に作成した「Technology.txt」というファイルから、{ "JAVA", "PYTHON", "JAVASCRIPT", "SELENIUM", "SCALA"} というシンプルなデータを読み込んでいます。

import java.nio.*;
import java.nio.file.*;
import java.io.*;
import java.util.stream.*;
import java.nio.charset.StandardCharsets;

public class ReadAllBytesMethodTest {
    public static void main(String args[]) {
        try(InputStream stream = Files.newInputStream(Paths.get("C://Temp//Technology.txt"))) {
            // ストリームを文字列に変換
            String contents = new String(stream.readAllBytes(), StandardCharsets.UTF_8);

            // 文字列の内容を出力
            System.out.println(contents);
        } catch(IOException ioe) {
            ioe.printStackTrace();
        }
    }
}

実行結果

"JAVA", "PYTHON", "JAVASCRIPT", "SELENIUM", "SCALA"

このように、readAllBytes()メソッドは設定ファイルやテキストファイルなど、サイズが小さく全体をまとめて読みたい場合に非常に便利です。一方、巨大なファイルを扱う場合はメモリ消費が大きくなるため、BufferedReaderなどで逐次読み込みを行う方法を検討しましょう。