Javaのファイル出力（書き込み）方法を解説！主要クラスの使い分けとコード例

Javaでアプリケーションを開発する際、データの永続化やログの出力、レポート作成など、ファイルへの書き込み操作は避けて通れない重要なタスクです。

Javaには長い歴史の中で進化してきた複数のファイル出力方法があり、用途に合わせて最適なクラスを選択することがパフォーマンスとコードの可読性を高める鍵となります。

古くから使われている java.io パッケージのクラスから、Java 7で導入された NIO.2 (New I/O) 、さらに Java 11 以降で追加された便利なメソッドまで、現代のJava開発におけるファイル出力の標準的な手法を詳しく解説します。

この記事を通じて、各クラスの特性を理解し、現場で即戦力として使える実装力を身につけていきましょう。

Javaにおけるファイル出力の基礎知識

Javaのファイル操作を理解する上で、まず押さえておくべきなのは「ストリーム (Stream)」という概念です。

データが流れるパイプのようなものをイメージしてください。

JavaのI/O (Input/Output) 処理は、大きく分けて2種類のストリームに分類されます。

バイトストリームと文字ストリームの違い

1つ目は バイトストリーム です。

これはデータを8ビットのバイナリデータとしてそのまま扱うもので、画像、音声、実行ファイルなどのバイナリファイルを扱う際に使用します。

代表的なクラスには FileOutputStream があります。

2つ目は 文字ストリーム です。

これはテキストデータを扱うために設計されており、Unicodeに基づいた文字の読み書きを行います。

内部的に文字エンコーディングの変換を行うため、テキストファイルを扱う場合はこちらを使用するのが一般的です。

代表的なクラスには FileWriter や BufferedWriter があります。

ファイル出力で考慮すべきポイント

ファイル出力を実装する際には、単に書き込むだけでなく、以下の3点に注意を払う必要があります。

バッファリング

ディスクへの書き込みはメモリアクセスに比べて低速です。

1文字ずつ書き込むのではなく、メモリ上に一時的にデータを溜めてからまとめて書き込むことで、処理速度を劇的に向上させることができます。

文字エンコーディング

日本語などのマルチバイト文字を扱う場合、UTF-8などの適切な文字コードを指定しないと文字化けの原因になります。

リソースの解放

ファイルをオープンした後は、必ずクローズしなければなりません。

これを怠ると「リソースリーク」が発生し、システムが不安定になる恐れがあります。

1. FileWriterとBufferedWriterによるテキスト出力

もっとも基本的かつ広く利用されているのが、FileWriter と BufferedWriter を組み合わせた方法です。

基本的な使い方

FileWriter はファイルに文字を書き込むためのクラスですが、これ単体では効率が良くありません。

そのため、通常は BufferedWriter でラップして使用します。

import java.io.BufferedWriter;
import java.io.FileWriter;
import java.io.IOException;

public class FileWriterExample {
    public static void main(String[] args) {
        String fileName = "example.txt";

        // try-with-resources文を使用して自動的にクローズする
        try (BufferedWriter writer = new BufferedWriter(new FileWriter(fileName))) {
            writer.write("こんにちは、Javaの世界へ！");
            writer.newLine(); // システム依存の改行コードを挿入
            writer.write("BufferedWriterを使うと効率的に書き込めます。");
            
            System.out.println("ファイルの書き込みが完了しました。");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

ファイルの書き込みが完了しました。

※ example.txt が生成され、指定したテキストが書き込まれます。

コードの解説

上記のコードで重要なのは try-with-resources文 の使用です。

Java 7以降、AutoCloseable インターフェースを実装したクラスを try ( ... ) の中で宣言することで、処理終了時に自動的に close() メソッドが呼ばれるようになりました。

これにより、開発者が手動で finally ブロックを書く必要がなくなり、クローズ漏れを防ぐことができます。

また、writer.newLine() は重要です。

OSによって改行コード (Windowsは \r\n、Linux/macOSは \n) は異なりますが、このメソッドを使うことでプログラムを実行している環境に適した改行コードを自動的に選択してくれます。

2. PrintWriterによる書式付き出力

ログファイルを出力する場合や、数値を特定の形式で出力したい場合には PrintWriter が便利です。

PrintWriterの特徴

PrintWriter は、System.out.println() と同じ感覚でファイルへの書き込みができるクラスです。

書式指定 (printf) や、自動フラッシュ機能 (データが溜まるのを待たずに即座に出力する機能) を備えています。

import java.io.FileWriter;
import java.io.IOException;
import java.io.PrintWriter;

public class PrintWriterExample {
    public static void main(String[] args) {
        String fileName = "formatted_output.txt";

        try (PrintWriter pw = new PrintWriter(new FileWriter(fileName))) {
            pw.println("----- 売上レポート -----");
            pw.printf("商品名: %s | 価格: %,d円%n", "高性能キーボード", 25800);
            pw.printf("商品名: %s | 価格: %,d円%n", "ワイヤレスマウス", 5400);
            pw.println("------------------------");
            
            System.out.println("レポートの出力に成功しました。");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

レポートの出力に成功しました。

※ formatted_output.txt の内容：

----- 売上レポート -----
商品名: 高性能キーボード | 価格: 25,800円
商品名: ワイヤレスマウス | 価格: 5,400円
------------------------

PrintWriter は、他のクラスと異なり、例外（IOException）をスローしないメソッドを多く持ちます。

エラーが発生したかどうかを確認するには checkError() メソッドを呼び出す必要がありますが、簡易的なツール作成などではコードをスッキリ書けるメリットがあります。

3. java.nio.file.Filesによる現代的な書き込み

Java 7以降で導入された NIO.2 の java.nio.file.Files クラスは、ファイル操作をより簡潔に行うための静的メソッドを豊富に備えています。

現代のJava開発では、まずこの Files クラスで実現できないかを検討するのがベストプラクティス とされています。

Files.write メソッド

リスト形式のデータを一括でファイルに書き込む場合に非常に強力です。

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.Arrays;
import java.util.List;
import java.io.IOException;

public class FilesWriteExample {
    public static void main(String[] args) {
        Path path = Paths.get("list_output.txt");
        List<String> lines = Arrays.asList("第一行", "第二行", "第三行");

        try {
            // 文字列のリストを一括で書き込み（デフォルトはUTF-8）
            Files.write(path, lines);
            System.out.println("NIO.2を使用した書き込みが完了しました。");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

Java 11以降の Files.writeString

Java 11ではさらに便利な writeString メソッドが追加されました。

単一の文字列をファイルに書き込むだけであれば、この1行で完結します。

import java.nio.file.Files;
import java.nio.file.Path;
import java.io.IOException;

public class Java11WriteExample {
    public static void main(String[] args) {
        Path path = Path.of("simple_output.txt");
        String content = "Java 11のFiles.writeStringは非常にシンプルです。";

        try {
            Files.writeString(path, content);
            System.out.println("簡潔な書き込みが完了しました。");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

NIO.2 を使用するメリットは、ストリームを明示的にクローズする記述を省略できる点（内部で自動処理されるため）や、Path オブジェクトによる直感的なファイルパス操作が可能になる点にあります。

4. 既存ファイルへの追記（Append）

デフォルトの設定では、ファイル出力を行うと既存のファイル内容は上書きされます。

既存の内容を保持したまま末尾にデータを追加したい場合は、追記モード (Append mode) を有効にする必要があります。

FileWriterでの追記

FileWriter のコンストラクタの第2引数に true を渡します。

// 第2引数のtrueが追記モードを指定
try (BufferedWriter writer = new BufferedWriter(new FileWriter("log.txt", true))) {
    writer.write("新しいログエントリーを追加します。");
    writer.newLine();
} catch (IOException e) {
    e.printStackTrace();
}

Files.writeでの追記

Files.write を使用する場合は、StandardOpenOption.APPEND を指定します。

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.StandardOpenOption;
import java.util.Collections;

// ...

Path path = Paths.get("log.txt");
try {
    Files.write(path, Collections.singletonList("NIO.2での追記"), StandardOpenOption.APPEND);
} catch (IOException e) {
    e.printStackTrace();
}

追記モードはログの記録やデータの累積処理などで多用されるため、必ず覚えておきましょう。

5. バイナリデータの出力（FileOutputStream）

テキストではなく、画像ファイルやシリアライズされたオブジェクトなどのバイナリデータを扱う場合は、文字ストリームではなく バイトストリーム を使用します。

FileOutputStreamの使い方

import java.io.FileOutputStream;
import java.io.BufferedOutputStream;
import java.io.IOException;

public class BinaryOutputExample {
    public static void main(String[] args) {
        String fileName = "data.bin";
        byte[] data = { 0x48, 0x65, 0x6C, 0x6C, 0x6F }; // "Hello" のバイト配列

        try (BufferedOutputStream bos = new BufferedOutputStream(new FileOutputStream(fileName))) {
            bos.write(data);
            bos.flush(); // 明示的にフラッシュ（バッファの内容を書き出す）
            System.out.println("バイナリデータの出力が完了しました。");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

バイナリ出力でも、BufferedOutputStream を使用してバッファリングを行うことが推奨されます。

また、ネットワーク経由でのデータ送信など、リアルタイム性が求められる場合は flush() を呼ぶタイミングに注意してください。

6. 文字エンコーディングの指定

現代のJava（特にJava 17以降）では、デフォルトの文字エンコーディングとして UTF-8 が採用される傾向にありますが、古いシステムとの連携などで Windows-31J (MS932) などを指定しなければならないケースがあります。

エンコーディングを明示する方法

java.io パッケージでエンコーディングを指定するには、OutputStreamWriter を介します。

import java.io.BufferedWriter;
import java.io.FileOutputStream;
import java.io.OutputStreamWriter;
import java.nio.charset.Charset;

// ...

try (BufferedWriter writer = new BufferedWriter(
        new OutputStreamWriter(new FileOutputStream("shift_jis.txt"), Charset.forName("Shift_JIS")))) {
    writer.write("Shift_JISで書き込みます。");
} catch (IOException e) {
    e.printStackTrace();
}

一方、Files.write を使う場合は、引数に Charset を渡すだけなので非常に簡単です。

Files.write(path, lines, Charset.forName("Shift_JIS"));

文字コードの不一致は、実行環境（OSやロケール）によって再現したりしなかったりする厄介なバグの原因になります。

可能な限り、プラットフォームのデフォルトに頼らず、明示的にエンコーディングを指定する習慣をつけましょう。

主要クラスの比較表

各クラスの特徴と使い分けを以下の表にまとめました。

パフォーマンスを最大化するためのベストプラクティス

Javaでのファイル出力をより効率的、かつ安全に行うためのポイントを3つ紹介します。

1. バッファサイズの最適化

BufferedWriter や BufferedOutputStream のデフォルトのバッファサイズは通常 8KB です。

非常に大きなファイルを扱う場合、このサイズを 16KB や 32KB に増やすことで、システムコールの回数を減らしパフォーマンスを向上させることができる場合があります。

// バッファサイズを32KBに指定
BufferedWriter writer = new BufferedWriter(new FileWriter(file), 32 * 1024);

2. 例外処理の徹底

ファイル操作は、ディスク容量不足、書き込み権限の欠如、ファイルロックなど、実行時に予期せぬエラーが発生しやすい処理です。

単に e.printStackTrace() するだけでなく、「エラー発生時にユーザーにどう通知するか」「中途半端に作成されたファイルを削除するか」 といったエラーリカバリの設計を忘れないようにしましょう。

3. 書き込み頻度の抑制

ループの中で1行ごとにファイルをオープン・クローズするのは最悪のアンチパターンです。

オープン・クローズの負荷は非常に高いため、可能な限り1回のオープンで全てのデータを書き込む、あるいはリストに溜めてから Files.write で一括出力するようにしましょう。

まとめ

Javaのファイル出力には、用途やJavaのバージョンに応じて多様な選択肢が用意されています。

• 大量のテキストデータ を効率よく書き込むなら、伝統的な BufferedWriter。
• 書式を整えて 出力したいなら、便利な PrintWriter。
• 最新のJava を利用しており、簡潔にコードを書きたいなら Files.write や Files.writeString。
• 画像やバイナリ を扱うなら FileOutputStream。

それぞれのクラスが持つ特性を理解し、「try-with-resourcesによる確実なクローズ」 と 「バッファリングによる効率化」 を意識することで、堅牢で高速なアプリケーションを構築することができます。

まずは、もっとも汎用性の高い NIO.2 (Files クラス) の使い方をマスターし、特殊な要件が必要になった際に java.io の詳細な設定を使い分けるというステップで学習を進めていくのが近道です。

この記事で紹介したサンプルコードをベースに、実際の開発現場で活用してみてください。