Java OutputStreamクラス：核心概念、メソッド、FileOutputStream実例

Java OutputStreamクラス

JavaのOutputStreamの基礎、主要メソッド、FileOutputStreamを使用した実践例を解説します。

OutputStreamクラスはjava.ioパッケージにあり、出力デスティネーションへのバイトストリームを表す抽象スーパークラスです。抽象クラスのため直接インスタンス化できず、具象サブクラスを使用して実際のI/O操作を行います。

OutputStreamの主要サブクラス

OutputStreamを拡張する最も一般的なサブクラス：

• FileOutputStream – バイトを直接ファイルに書き込み
• ByteArrayOutputStream – 拡張可能な配列にバイトを取得、メモリ内操作に有用
• ObjectOutputStream – Javaオブジェクトをバイトストリームにシリアル化

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

OutputStreamインスタンスの作成

OutputStreamインスタンスを作成するには、パッケージをインポートし具象サブクラスをインスタンス化：

// FileOutputStreamをインスタンス化
OutputStream out = new FileOutputStream("example.txt");

OutputStreamは抽象クラスなので、常にサブクラスを使用する必要があります。上記はexample.txtに書き込むストリームを作成します。

ヒント: FileOutputStreamを他のサブクラス（ByteArrayOutputStreamなど）に置き換えて、異なるデスティネーションを対象にできます。

OutputStreamのコアメソッド

抽象クラスが宣言する、サブクラスが実装必須の主要メソッド：

• write(int b) – 1バイトをストリームに書き込み
• write(byte[] b) – バイト配列全体を書き込み
• flush() – バッファされたデータを強制的に書き出し
• close() – ストリームに関連するシステムリソースを解放

例：FileOutputStreamでテキストをファイルに書き込み

FileOutputStreamを使用してテキスト行をoutput.txtに書き込む完全なプログラム：

import java.io.FileOutputStream;
import java.io.OutputStream;

public class Main {
    public static void main(String[] args) {
        String data = "This is a line of text inside the file.";
        try (OutputStream out = new FileOutputStream("output.txt")) {
            byte[] dataBytes = data.getBytes();
            out.write(dataBytes);
            System.out.println("データをoutput.txtに書き込みました");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

示されている重要ポイント：

• getBytes()でStringをバイト配列に変換
• write()でバイト配列をストリームに書き込み
• try-with-resourcesブロックで自動的にストリームをクローズ（close()を呼び出し）

実行後、output.txtには以下が含まれます：

This is a line of text inside the file.

詳細については公式Javaドキュメントを参照：Java OutputStream (公式Javaドキュメント)