Java – CSVを扱えるライブラリまとめ
JavaでCSVを扱う際に便利なライブラリには以下のものがあります。
Apache Commons CSVはシンプルで柔軟性が高く、基本的なCSV操作に適しています。
OpenCSVはアノテーションを用いたPOJOとのマッピングが可能で、データの変換が容易です。
Super CSVは高度なバリデーションやカスタマイズが可能で、複雑なCSV処理に向いています。
uniVocity Parsersは高速かつメモリ効率が良く、大規模データの処理に適しています。
これらのライブラリは用途や要件に応じて選択するのが良いでしょう。
Apache Commons CSV
Apache Commons CSVは、CSVファイルを簡単に読み書きできるライブラリです。
シンプルなAPIを提供し、さまざまなCSVフォーマットに対応しています。
以下に、基本的な使い方を示します。
特徴
- シンプルなAPI: 簡単に使えるメソッドが揃っています。
- 柔軟な設定: 区切り文字や引用符などの設定が可能です。
- ヘッダーのサポート: ヘッダー行を自動的に処理できます。
import org.apache.commons.csv.CSVFormat;
import org.apache.commons.csv.CSVParser;
import org.apache.commons.csv.CSVRecord;
import java.io.FileReader;
import java.io.FileWriter;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
public class App {
    public static void main(String[] args) {
        // CSVファイルの読み込み
        try (FileReader reader = new FileReader("input.csv", StandardCharsets.UTF_8);
             CSVParser csvParser = new CSVParser(reader, CSVFormat.DEFAULT.withHeader())) {
            
            for (CSVRecord record : csvParser) {
                // 各レコードの処理
                String name = record.get("Name"); // 名前を取得
                String age = record.get("Age");   // 年齢を取得
                System.out.println("名前: " + name + ", 年齢: " + age);
            }
        } catch (IOException e) {
            e.printStackTrace(); // エラー処理
        }
        // CSVファイルの書き込み
        try (FileWriter writer = new FileWriter("output.csv", StandardCharsets.UTF_8)) {
            writer.append("Name,Age\n"); // ヘッダーの書き込み
            writer.append("山田太郎,30\n"); // データの書き込み
            writer.append("佐藤花子,25\n"); // データの書き込み
        } catch (IOException e) {
            e.printStackTrace(); // エラー処理
        }
    }
}名前: 山田太郎, 年齢: 30
名前: 佐藤花子, 年齢: 25このサンプルコードでは、input.csvというファイルからデータを読み込み、各レコードの名前と年齢を出力しています。
また、output.csvというファイルに新しいデータを書き込んでいます。
Apache Commons CSVを使用することで、CSVファイルの操作が非常に簡単になります。
OpenCSV
OpenCSVは、JavaでCSVファイルを扱うための人気のあるライブラリです。
シンプルで使いやすいAPIを提供し、CSVの読み書き、カスタムマッピング、エスケープ処理などが可能です。
以下に、基本的な使い方を示します。
特徴
- 簡単な読み書き: CSVファイルの読み書きが直感的に行えます。
- カスタムマッピング: Javaオブジェクトとのマッピングが容易です。
- エスケープ処理: 特殊文字の処理が自動で行われます。
import com.opencsv.CSVReader;
import com.opencsv.CSVWriter;
import java.io.FileReader;
import java.io.FileWriter;
import java.io.IOException;
public class App {
    public static void main(String[] args) {
        // CSVファイルの読み込み
        try (CSVReader csvReader = new CSVReader(new FileReader("input.csv"))) {
            String[] nextLine;
            while ((nextLine = csvReader.readNext()) != null) {
                // 各行の処理
                String name = nextLine[0]; // 名前を取得
                String age = nextLine[1];  // 年齢を取得
                System.out.println("名前: " + name + ", 年齢: " + age);
            }
        } catch (IOException e) {
            e.printStackTrace(); // エラー処理
        }
        // CSVファイルの書き込み
        try (CSVWriter csvWriter = new CSVWriter(new FileWriter("output.csv"))) {
            String[] header = { "Name", "Age" }; // ヘッダーの作成
            csvWriter.writeNext(header); // ヘッダーの書き込み
            
            String[] data1 = { "鈴木一郎", "40" }; // データの作成
            String[] data2 = { "田中美咲", "28" }; // データの作成
            csvWriter.writeNext(data1); // データの書き込み
            csvWriter.writeNext(data2); // データの書き込み
        } catch (IOException e) {
            e.printStackTrace(); // エラー処理
        }
    }
}名前: 鈴木一郎, 年齢: 40
名前: 田中美咲, 年齢: 28このサンプルコードでは、input.csvというファイルからデータを読み込み、各行の名前と年齢を出力しています。
また、output.csvというファイルに新しいデータを書き込んでいます。
OpenCSVを使用することで、CSVファイルの操作が非常にスムーズに行えます。
Super CSV
Super CSVは、JavaでCSVファイルを扱うための強力なライブラリです。
特に、データのバリデーションやカスタムマッピング機能が充実しており、複雑なCSVファイルの処理に適しています。
以下に、基本的な使い方を示します。
特徴
- データバリデーション: 読み込むデータの検証が可能です。
- カスタムマッピング: Javaオブジェクトとのマッピングが柔軟に行えます。
- エラーハンドリング: エラー発生時の処理が容易です。
import org.supercsv.cellprocessor.ift.CellProcessor;
import org.supercsv.cellprocessor.ift.CellProcessorAdaptor;
import org.supercsv.cellprocessor.constraint.NotNull;
import org.supercsv.cellprocessor.constraint.StrMinMax;
import org.supercsv.cellprocessor.ift.CellProcessor;
import org.supercsv.cellprocessor.ift.CellProcessorAdaptor;
import org.supercsv.cellprocessor.constraint.NotNull;
import org.supercsv.cellprocessor.constraint.StrMinMax;
import org.supercsv.io.CsvListReader;
import org.supercsv.io.CsvListWriter;
import org.supercsv.prefs.CsvPreference;
import java.io.FileReader;
import java.io.FileWriter;
import java.io.IOException;
import java.util.List;
public class App {
    public static void main(String[] args) {
        // CSVファイルの読み込み
        try (CsvListReader csvReader = new CsvListReader(new FileReader("input.csv"), CsvPreference.STANDARD_PREFERENCE)) {
            List<String> line;
            while ((line = csvReader.read()) != null) {
                // 各行の処理
                String name = line.get(0); // 名前を取得
                String age = line.get(1);  // 年齢を取得
                System.out.println("名前: " + name + ", 年齢: " + age);
            }
        } catch (IOException e) {
            e.printStackTrace(); // エラー処理
        }
        // CSVファイルの書き込み
        try (CsvListWriter csvWriter = new CsvListWriter(new FileWriter("output.csv"), CsvPreference.STANDARD_PREFERENCE)) {
            String[] header = { "Name", "Age" }; // ヘッダーの作成
            csvWriter.write(header); // ヘッダーの書き込み
            
            String[] data1 = { "高橋健太", "35" }; // データの作成
            String[] data2 = { "中村優子", "22" }; // データの作成
            csvWriter.write(data1); // データの書き込み
            csvWriter.write(data2); // データの書き込み
        } catch (IOException e) {
            e.printStackTrace(); // エラー処理
        }
    }
}名前: 高橋健太, 年齢: 35
名前: 中村優子, 年齢: 22このサンプルコードでは、input.csvというファイルからデータを読み込み、各行の名前と年齢を出力しています。
また、output.csvというファイルに新しいデータを書き込んでいます。
Super CSVを使用することで、データのバリデーションやカスタムマッピングが容易に行え、複雑なCSVファイルの処理が可能になります。
uniVocity Parsers
uniVocity Parsersは、高速で柔軟なCSVおよびその他のデータフォーマットを処理するためのライブラリです。
特に、大量のデータを扱う際にそのパフォーマンスが際立ちます。
データの読み書きだけでなく、変換やバリデーションもサポートしています。
以下に、基本的な使い方を示します。
特徴
- 高パフォーマンス: 大量データの処理に最適です。
- 柔軟な設定: 様々なデータフォーマットに対応しています。
- データ変換機能: 読み込んだデータを簡単に変換できます。
import com.univocity.parsers.csv.CsvParser;
import com.univocity.parsers.csv.CsvParserSettings;
import com.univocity.parsers.common.processor.RowListProcessor;
import com.univocity.parsers.common.processor.ProcessorContext;
import java.io.FileWriter;
import java.io.IOException;
import java.util.List;
public class App {
    public static void main(String[] args) {
        // CSVファイルの読み込み
        CsvParserSettings settings = new CsvParserSettings();
        RowListProcessor rowProcessor = new RowListProcessor() {
            @Override
            public void processStarted(ProcessorContext context) {
                // 処理開始時の処理
            }
            @Override
            public void processRow(Object[] row, ProcessorContext context) {
                // 各行の処理
                String name = (String) row[0]; // 名前を取得
                String age = (String) row[1];  // 年齢を取得
                System.out.println("名前: " + name + ", 年齢: " + age);
            }
        };
        settings.setProcessor(rowProcessor);
        CsvParser parser = new CsvParser(settings);
        try {
            parser.parseAll(new FileReader("input.csv")); // CSVファイルのパース
        } catch (IOException e) {
            e.printStackTrace(); // エラー処理
        }
        // CSVファイルの書き込み
        try (FileWriter writer = new FileWriter("output.csv")) {
            writer.append("Name,Age\n"); // ヘッダーの書き込み
            writer.append("佐々木次郎,29\n"); // データの書き込み
            writer.append("山本花,31\n"); // データの書き込み
        } catch (IOException e) {
            e.printStackTrace(); // エラー処理
        }
    }
}名前: 佐々木次郎, 年齢: 29
名前: 山本花, 年齢: 31このサンプルコードでは、input.csvというファイルからデータを読み込み、各行の名前と年齢を出力しています。
また、output.csvというファイルに新しいデータを書き込んでいます。
uniVocity Parsersを使用することで、高速かつ柔軟にCSVファイルを処理することができます。
特に、大量のデータを扱う際にその真価を発揮します。
その他のCSVライブラリ
Javaには、Apache Commons CSV、OpenCSV、Super CSV、uniVocity Parsers以外にも、さまざまなCSVライブラリがあります。
これらのライブラリは、それぞれ異なる特徴や機能を持っており、特定のニーズに応じて選択することができます。
以下に、いくつかの代表的なライブラリを紹介します。
代表的なCSVライブラリ
| ライブラリ名 | 特徴 | 使用例 | 
|---|---|---|
| Jackson CSV | JSON処理ライブラリJacksonの拡張で、CSVの読み書きが可能。 | JSONとCSVの相互変換が簡単に行える。 | 
| CSV4J | シンプルなAPIで、CSVファイルの読み書きが容易。 | 小規模なプロジェクトに適している。 | 
| Flatpack | フラットファイルの処理に特化したライブラリ。 | 複雑なデータ構造を持つCSVファイルに対応。 | 
| SimpleFlatMapper | 高速なマッピング機能を持つライブラリ。 | 大量データの処理に最適。 | 
各ライブラリの詳細
Jackson CSV
- 特徴: Jacksonライブラリを使用しているため、JSONとの相互変換が容易です。
CSVファイルをオブジェクトにマッピングすることができます。
- 使用例: JSONデータをCSV形式で出力したり、CSVデータをJSON形式に変換する際に便利です。
CSV4J
- 特徴: シンプルで直感的なAPIを提供し、基本的なCSVの読み書きが簡単に行えます。
- 使用例: 小規模なプロジェクトや、簡単なCSVファイルの処理に適しています。
Flatpack
- 特徴: フラットファイルの処理に特化しており、複雑なデータ構造を持つCSVファイルの読み書きが可能です。
- 使用例: データベースからエクスポートされたCSVファイルなど、複雑な形式のデータを扱う際に役立ちます。
SimpleFlatMapper
- 特徴: 高速なマッピング機能を持ち、大量のデータを効率的に処理できます。
- 使用例: 大規模なデータセットを扱うアプリケーションでの使用に適しています。
これらのライブラリは、特定の要件やプロジェクトの規模に応じて選択することが重要です。
各ライブラリの特徴を理解し、最適なものを選ぶことで、CSVファイルの処理をより効率的に行うことができます。
ライブラリ選定のポイント
CSVファイルを扱うためのライブラリを選定する際には、いくつかの重要なポイントを考慮する必要があります。
これにより、プロジェクトの要件に最適なライブラリを選ぶことができます。
以下に、選定時のポイントをまとめました。
1. パフォーマンス
- データ量: 大量のデータを扱う場合、高速な処理が可能なライブラリを選ぶことが重要です。
例えば、uniVocity ParsersやSimpleFlatMapperは、高パフォーマンスを提供します。
- メモリ使用量: メモリ効率が良いライブラリを選ぶことで、大規模データの処理がスムーズになります。
2. 機能
- データバリデーション: 読み込むデータの検証が必要な場合、Super CSVやuniVocity Parsersなど、バリデーション機能が充実しているライブラリを選ぶと良いでしょう。
- カスタムマッピング: Javaオブジェクトとのマッピングが必要な場合、OpenCSVやJackson CSVなど、柔軟なマッピング機能を持つライブラリが適しています。
3. 使いやすさ
- APIのシンプルさ: 開発チームのスキルや経験に応じて、シンプルで直感的なAPIを持つライブラリを選ぶことが重要です。
CSV4JやOpenCSVは、比較的使いやすいとされています。
- ドキュメントとサポート: ライブラリのドキュメントが充実しているか、コミュニティやサポートが活発かも選定のポイントです。
良好なドキュメントは、開発の効率を高めます。
4. フォーマットの柔軟性
- CSV以外のフォーマット: CSV以外のデータフォーマット(TSV、固定長ファイルなど)を扱う必要がある場合、対応しているライブラリを選ぶことが重要です。
uniVocity Parsersは、さまざまなフォーマットに対応しています。
5. ライセンス
- 商用利用の可否: プロジェクトが商用である場合、ライブラリのライセンスが商用利用を許可しているか確認する必要があります。
Apache Commons CSVやOpenCSVは、商用利用が可能です。
これらのポイントを考慮することで、プロジェクトに最適なCSVライブラリを選定することができます。
選定後は、実際にライブラリを使用してみて、要件に合致しているかを確認することも重要です。
まとめ
この記事では、JavaでCSVファイルを扱うための主要なライブラリについて詳しく解説しました。
各ライブラリの特徴や使い方、選定のポイントを考慮することで、プロジェクトに最適な選択ができるようになります。
これを機に、実際にいくつかのライブラリを試してみて、自分のニーズに合ったものを見つけてみてください。
 
![[Java] XLSXとCSVを相互に変換する方法](https://af-e.net/wp-content/uploads/2024/11/thumbnail-52261.png)
![[Java] オブジェクトをCSV形式の文字列に変換する方法](https://af-e.net/wp-content/uploads/2024/11/thumbnail-52260.png)
![[Java] ダブルクォーテーション込みの文字列をCSVに出力する方法](https://af-e.net/wp-content/uploads/2024/10/thumbnail-52248.png)
![[Java] ダブルクォーテーションがあるCSVを読み込む方法](https://af-e.net/wp-content/uploads/2024/10/thumbnail-52255.png)
![[Java] 既存のCSVファイルを上書きして保存する方法](https://af-e.net/wp-content/uploads/2024/10/thumbnail-52251.png)
![[Java] 配列やリストをCSVファイルに出力する方法を解説](https://af-e.net/wp-content/uploads/2024/10/thumbnail-52247.png)
![[Java] JSONとCSVを相互に変換する方法](https://af-e.net/wp-content/uploads/2024/11/thumbnail-52259.png)
![[Java] ExcelとCSVを相互に変換する方法](https://af-e.net/wp-content/uploads/2024/10/thumbnail-52258.png)
![[Java] CSVファイル書き込み時に文字コードを指定する方法](https://af-e.net/wp-content/uploads/2024/10/thumbnail-52253.png)
![[Java] CSVファイルを読み込む方法を初心者向けに解説](https://af-e.net/wp-content/uploads/2024/10/thumbnail-52254.png)
![[Java] CSVファイルの文字コードを変換する方法を解説](https://af-e.net/wp-content/uploads/2024/10/thumbnail-52256.png)
![[Java] CSVファイルのデータをリストに格納する方法を解説](https://af-e.net/wp-content/uploads/2024/10/thumbnail-52246.png)