csv

Java – 配列やリストをCSVファイルに出力する方法を解説

2025-04-15更新日: 2025-04-15

Javaで配列やリストをCSVファイルに出力するには、FileWriterやBufferedWriterを使用してデータをCSV形式で書き込む方法が一般的です。

各要素をカンマ,で区切り、行ごとに改行を挿入します。

String.joinを使うと配列やリストを簡単にカンマ区切りの文字列に変換できます。

また、Apache Commons CSVやOpenCSVといったライブラリを利用すると、エスケープ処理や特殊文字の対応が容易になります。

目次から探す

Java標準ライブラリを使ったCSVファイルの出力方法
Apache Commons CSVを使ったCSVファイルの出力方法
- 依存関係の追加
OpenCSVを使ったCSVファイルの出力方法
- 依存関係の追加
特殊ケースへの対応方法
実践的な応用例
エラー処理とデバッグのポイント
まとめ

Java標準ライブラリを使ったCSVファイルの出力方法

Javaの標準ライブラリを使用して、配列やリストのデータをCSVファイルに出力する方法を解説します。

ここでは、FileWriterとPrintWriterを使った基本的な方法を紹介します。

以下のコードは、配列のデータをCSV形式でファイルに出力する例です。

import java.io.FileWriter; // ファイル書き込み用
import java.io.PrintWriter; // 印刷用
import java.io.IOException; // 例外処理用
public class App {
    public static void main(String[] args) {
        // 出力するデータの配列
        String[] data = {"名前,年齢,性別", "田中,30,男性", "佐藤,25,女性", "鈴木,40,男性"};
        
        // CSVファイルに書き込む
        try (PrintWriter writer = new PrintWriter(new FileWriter("output.csv"))) {
            for (String line : data) {
                // 配列の各行をCSV形式で書き込む
                writer.println(line); 
            }
        } catch (IOException e) {
            // 例外が発生した場合の処理
            e.printStackTrace(); 
        }
    }
}

上記のコードを実行すると、output.csvというファイルが生成され、以下の内容が書き込まれます。

名前,年齢,性別
田中,30,男性
佐藤,25,女性
鈴木,40,男性

このコードでは、FileWriterを使用してファイルを作成し、PrintWriterを使ってデータを書き込んでいます。

try-with-resources文を使用することで、リソースの自動クローズが行われ、例外処理も簡潔に記述できます。

Apache Commons CSVを使ったCSVファイルの出力方法

Apache Commons CSVは、CSVファイルの読み書きを簡単に行うためのライブラリです。

このライブラリを使用することで、CSVファイルの出力がより直感的に行えます。

以下では、Apache Commons CSVを使ってリストのデータをCSV形式で出力する方法を紹介します。

依存関係の追加

Apache Commons CSVを使用するには、まずMavenプロジェクトに依存関係を追加する必要があります。

pom.xmlに以下の依存関係を追加してください。

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-csv</artifactId>
    <version>1.9.0</version> <!-- 最新のバージョンを確認してください -->
</dependency>

以下のコードは、リストのデータをCSV形式でファイルに出力する例です。

import org.apache.commons.csv.CSVFormat; // CSVフォーマット用
import org.apache.commons.csv.CSVPrinter; // CSVプリンタ用
import java.io.FileWriter; // ファイル書き込み用
import java.io.IOException; // 例外処理用
import java.util.ArrayList; // リスト用
import java.util.List; // リスト用
public class App {
    public static void main(String[] args) {
        // 出力するデータのリスト
        List<String[]> data = new ArrayList<>();
        data.add(new String[]{"名前", "年齢", "性別"});
        data.add(new String[]{"田中", "30", "男性"});
        data.add(new String[]{"佐藤", "25", "女性"});
        data.add(new String[]{"鈴木", "40", "男性"});
        
        // CSVファイルに書き込む
        try (CSVPrinter printer = new CSVPrinter(new FileWriter("output.csv"), CSVFormat.DEFAULT)) {
            for (String[] line : data) {
                // リストの各行をCSV形式で書き込む
                printer.printRecord((Object[]) line); 
            }
        } catch (IOException e) {
            // 例外が発生した場合の処理
            e.printStackTrace(); 
        }
    }
}

上記のコードを実行すると、output.csvというファイルが生成され、以下の内容が書き込まれます。

名前,年齢,性別
田中,30,男性
佐藤,25,女性
鈴木,40,男性

このコードでは、CSVPrinterを使用してリストのデータをCSV形式で出力しています。

CSVFormat.DEFAULTを指定することで、デフォルトのCSVフォーマットが適用されます。

Apache Commons CSVを使用することで、CSVファイルの出力がより簡潔で可読性の高いコードになります。

OpenCSVを使ったCSVファイルの出力方法

OpenCSVは、JavaでCSVファイルを簡単に操作するためのライブラリです。

このライブラリを使用することで、CSVファイルの読み書きが非常に簡単になります。

以下では、OpenCSVを使って配列のデータをCSV形式で出力する方法を紹介します。

依存関係の追加

OpenCSVを使用するには、まずMavenプロジェクトに依存関係を追加する必要があります。

pom.xmlに以下の依存関係を追加してください。

<dependency>
    <groupId>com.opencsv</groupId>
    <artifactId>opencsv</artifactId>
    <version>5.5.2</version> <!-- 最新のバージョンを確認してください -->
</dependency>

以下のコードは、配列のデータをCSV形式でファイルに出力する例です。

import com.opencsv.CSVWriter; // CSVライター用
import java.io.FileWriter; // ファイル書き込み用
import java.io.IOException; // 例外処理用
public class App {
    public static void main(String[] args) {
        // 出力するデータの配列
        String[][] data = {
            {"名前", "年齢", "性別"},
            {"田中", "30", "男性"},
            {"佐藤", "25", "女性"},
            {"鈴木", "40", "男性"}
        };
        
        // CSVファイルに書き込む
        try (CSVWriter writer = new CSVWriter(new FileWriter("output.csv"))) {
            // 配列の各行をCSV形式で書き込む
            writer.writeAll(java.util.Arrays.asList(data)); 
        } catch (IOException e) {
            // 例外が発生した場合の処理
            e.printStackTrace(); 
        }
    }
}

上記のコードを実行すると、output.csvというファイルが生成され、以下の内容が書き込まれます。

名前,年齢,性別
田中,30,男性
佐藤,25,女性
鈴木,40,男性

このコードでは、CSVWriterを使用して配列のデータをCSV形式で出力しています。

writeAllメソッドを使うことで、配列全体を一度に書き込むことができ、コードがシンプルになります。

OpenCSVを利用することで、CSVファイルの操作がより効率的に行えるようになります。

特殊ケースへの対応方法

CSVファイルの出力時には、特定の特殊ケースに対処する必要があります。

ここでは、一般的な特殊ケースとその対応方法について解説します。

データにカンマが含まれる場合

データにカンマが含まれている場合、そのデータを引用符で囲む必要があります。

これにより、CSVフォーマットが正しく保たれます。

import com.opencsv.CSVWriter; // CSVライター用
import java.io.FileWriter; // ファイル書き込み用
import java.io.IOException; // 例外処理用
public class App {
    public static void main(String[] args) {
        // 出力するデータの配列(カンマを含むデータ)
        String[][] data = {
            {"名前", "年齢", "性別"},
            {"田中,太郎", "30", "男性"},
            {"佐藤", "25", "女性"},
            {"鈴木", "40", "男性"}
        };
        
        // CSVファイルに書き込む
        try (CSVWriter writer = new CSVWriter(new FileWriter("output.csv"))) {
            // 配列の各行をCSV形式で書き込む
            writer.writeAll(java.util.Arrays.asList(data)); 
        } catch (IOException e) {
            // 例外が発生した場合の処理
            e.printStackTrace(); 
        }
    }
}

データに改行が含まれる場合

データに改行が含まれている場合も、引用符で囲むことで正しく処理できます。

OpenCSVは自動的にこの処理を行います。

import com.opencsv.CSVWriter; // CSVライター用
import java.io.FileWriter; // ファイル書き込み用
import java.io.IOException; // 例外処理用
public class App {
    public static void main(String[] args) {
        // 出力するデータの配列(改行を含むデータ)
        String[][] data = {
            {"名前", "年齢", "性別"},
            {"田中\n太郎", "30", "男性"},
            {"佐藤", "25", "女性"},
            {"鈴木", "40", "男性"}
        };
        
        // CSVファイルに書き込む
        try (CSVWriter writer = new CSVWriter(new FileWriter("output.csv"))) {
            // 配列の各行をCSV形式で書き込む
            writer.writeAll(java.util.Arrays.asList(data)); 
        } catch (IOException e) {
            // 例外が発生した場合の処理
            e.printStackTrace(); 
        }
    }
}

空のフィールドの処理

空のフィールドは、CSVファイルでは何も書かないことで表現できます。

OpenCSVは自動的に空のフィールドを処理します。

import com.opencsv.CSVWriter; // CSVライター用
import java.io.FileWriter; // ファイル書き込み用
import java.io.IOException; // 例外処理用
public class App {
    public static void main(String[] args) {
        // 出力するデータの配列(空のフィールドを含むデータ)
        String[][] data = {
            {"名前", "年齢", "性別"},
            {"田中", "", "男性"},
            {"佐藤", "25", ""},
            {"鈴木", "40", "男性"}
        };
        
        // CSVファイルに書き込む
        try (CSVWriter writer = new CSVWriter(new FileWriter("output.csv"))) {
            // 配列の各行をCSV形式で書き込む
            writer.writeAll(java.util.Arrays.asList(data)); 
        } catch (IOException e) {
            // 例外が発生した場合の処理
            e.printStackTrace(); 
        }
    }
}

これらの特殊ケースに対処することで、CSVファイルの出力がより正確で信頼性の高いものになります。

OpenCSVはこれらのケースに対しても柔軟に対応できるため、非常に便利なライブラリです。

実践的な応用例

ここでは、Javaを使用してCSVファイルを出力する実践的な応用例をいくつか紹介します。

これにより、実際のプロジェクトでの活用方法を理解しやすくなります。

ユーザー情報のエクスポート

ユーザー情報をCSVファイルにエクスポートするシンプルなアプリケーションの例です。

ユーザーの名前、メールアドレス、登録日を含むデータをCSV形式で出力します。

import com.opencsv.CSVWriter; // CSVライター用
import java.io.FileWriter; // ファイル書き込み用
import java.io.IOException; // 例外処理用
import java.util.ArrayList; // リスト用
import java.util.List; // リスト用
public class App {
    public static void main(String[] args) {
        // ユーザー情報のリスト
        List<String[]> users = new ArrayList<>();
        users.add(new String[]{"名前", "メールアドレス", "登録日"});
        users.add(new String[]{"田中太郎", "tanaka@example.com", "2023-01-15"});
        users.add(new String[]{"佐藤花子", "sato@example.com", "2023-02-20"});
        users.add(new String[]{"鈴木次郎", "suzuki@example.com", "2023-03-10"});
        
        // CSVファイルに書き込む
        try (CSVWriter writer = new CSVWriter(new FileWriter("users.csv"))) {
            // ユーザー情報をCSV形式で書き込む
            writer.writeAll(users); 
        } catch (IOException e) {
            // 例外が発生した場合の処理
            e.printStackTrace(); 
        }
    }
}

商品データのエクスポート

商品情報をCSVファイルにエクスポートするアプリケーションの例です。

商品名、価格、在庫数を含むデータをCSV形式で出力します。

import com.opencsv.CSVWriter; // CSVライター用
import java.io.FileWriter; // ファイル書き込み用
import java.io.IOException; // 例外処理用
import java.util.ArrayList; // リスト用
import java.util.List; // リスト用
public class App {
    public static void main(String[] args) {
        // 商品情報のリスト
        List<String[]> products = new ArrayList<>();
        products.add(new String[]{"商品名", "価格", "在庫数"});
        products.add(new String[]{"ノートパソコン", "100000", "50"});
        products.add(new String[]{"スマートフォン", "80000", "100"});
        products.add(new String[]{"タブレット", "60000", "30"});
        
        // CSVファイルに書き込む
        try (CSVWriter writer = new CSVWriter(new FileWriter("products.csv"))) {
            // 商品情報をCSV形式で書き込む
            writer.writeAll(products); 
        } catch (IOException e) {
            // 例外が発生した場合の処理
            e.printStackTrace(); 
        }
    }
}

ログデータのエクスポート

アプリケーションのログデータをCSVファイルにエクスポートする例です。

ログのタイムスタンプ、レベル、メッセージを含むデータをCSV形式で出力します。

import com.opencsv.CSVWriter; // CSVライター用
import java.io.FileWriter; // ファイル書き込み用
import java.io.IOException; // 例外処理用
import java.util.ArrayList; // リスト用
import java.util.List; // リスト用
public class App {
    public static void main(String[] args) {
        // ログデータのリスト
        List<String[]> logs = new ArrayList<>();
        logs.add(new String[]{"タイムスタンプ", "レベル", "メッセージ"});
        logs.add(new String[]{"2023-01-01 10:00:00", "INFO", "アプリケーションが起動しました"});
        logs.add(new String[]{"2023-01-01 10:05:00", "ERROR", "データベース接続に失敗しました"});
        logs.add(new String[]{"2023-01-01 10:10:00", "WARN", "メモリ使用量が高くなっています"});
        
        // CSVファイルに書き込む
        try (CSVWriter writer = new CSVWriter(new FileWriter("logs.csv"))) {
            // ログデータをCSV形式で書き込む
            writer.writeAll(logs); 
        } catch (IOException e) {
            // 例外が発生した場合の処理
            e.printStackTrace(); 
        }
    }
}

これらの実践的な応用例を通じて、CSVファイルの出力がどのように行われるかを理解できるでしょう。

ユーザー情報や商品データ、ログデータなど、さまざまなデータをCSV形式でエクスポートすることで、データの管理や分析が容易になります。

OpenCSVを活用することで、これらの処理を簡単に実装できます。

エラー処理とデバッグのポイント

CSVファイルの出力時には、さまざまなエラーが発生する可能性があります。

ここでは、一般的なエラー処理の方法とデバッグのポイントについて解説します。

例外処理の基本

CSVファイルの書き込み時には、IOExceptionが発生する可能性があります。

これを適切に処理することで、アプリケーションの安定性を向上させることができます。

以下のポイントに注意してください。

try-catch文の使用: ファイル操作を行う際は、必ずtry-catch文を使用して例外を捕捉します。
エラーメッセージの出力: 例外が発生した場合は、エラーメッセージを出力して、問題の特定を容易にします。

import com.opencsv.CSVWriter; // CSVライター用
import java.io.FileWriter; // ファイル書き込み用
import java.io.IOException; // 例外処理用
public class App {
    public static void main(String[] args) {
        // CSVファイルに書き込む
        try (CSVWriter writer = new CSVWriter(new FileWriter("output.csv"))) {
            // データを書き込む
            String[] data = {"名前", "年齢", "性別"};
            writer.writeNext(data); 
        } catch (IOException e) {
            // 例外が発生した場合の処理
            System.err.println("ファイル書き込み中にエラーが発生しました: " + e.getMessage()); 
        }
    }
}

ファイルパスの確認

ファイルの書き込み先パスが正しいかどうかを確認することも重要です。

特に、相対パスを使用する場合は、実行環境によって異なる場合があります。

以下のポイントに注意してください。

絶対パスの使用: 開発中は絶対パスを使用して、ファイルの書き込み先を明確にします。
ディレクトリの存在確認: 書き込み先のディレクトリが存在するかどうかを確認し、存在しない場合は作成します。

import com.opencsv.CSVWriter; // CSVライター用
import java.io.FileWriter; // ファイル書き込み用
import java.io.IOException; // 例外処理用
import java.io.File; // ファイル操作用
public class App {
    public static void main(String[] args) {
        String filePath = "output.csv"; // 書き込み先のファイルパス
        
        // ディレクトリの存在確認
        File file = new File(filePath);
        if (!file.getParentFile().exists()) {
            System.err.println("指定されたディレクトリが存在しません: " + file.getParent());
            return; // 処理を中止
        }
        
        // CSVファイルに書き込む
        try (CSVWriter writer = new CSVWriter(new FileWriter(filePath))) {
            // データを書き込む
            String[] data = {"名前", "年齢", "性別"};
            writer.writeNext(data); 
        } catch (IOException e) {
            // 例外が発生した場合の処理
            System.err.println("ファイル書き込み中にエラーが発生しました: " + e.getMessage()); 
        }
    }
}