JavaのJacksonライブラリを使ってCSVをJSONに変換する方法

Jacksonは、JSONを操作するための多彩な機能を提供するJava向けJSON APIです。CSVデータをJSONデータへ変換する際には、CsvMapperクラスを利用します。CsvMapperはObjectMapperを特殊化したクラスであり、POJO（Plain Old Java Object）からCsvSchemaインスタンスを生成できる拡張機能を持っています。

CSVファイルを読み込むには、デフォルト設定でObjectReaderを構築するreader()メソッドを使用します。また、変換処理を行う前に、com.fasterxml.jackson.dataformat.csvパッケージをプロジェクトに追加しておく必要があります。

必要な依存関係（Mavenの場合）

<dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-csv</artifactId>
    <version>2.15.2</version>
</dependency>

入力CSVファイル（input.csv）

last name,first name,location
Chandra,Ravi,Bangalore

CSVからJSONへの変換サンプルコード

以下の例では、ヘッダー行を持つCSVファイルを読み込み、Map形式のリストとしてJSONデータに変換しています。

import java.io.*;
import java.util.*;
import com.fasterxml.jackson.databind.*;
import com.fasterxml.jackson.dataformat.csv.*;

public class CsvToJsonTest {
    public static void main(String args[]) throws Exception {
        File input = new File("input.csv");
        try {
            // ヘッダー行を持つ空のスキーマを定義
            CsvSchema csv = CsvSchema.emptySchema().withHeader();
            // CsvMapperのインスタンスを生成
            CsvMapper csvMapper = new CsvMapper();
            // reader()でObjectReaderを作成し、CSVを読み込む
            MappingIterator<Map<?, ?>> mappingIterator =
                    csvMapper.reader().forType(Map.class).with(csv).readValues(input);
            // 全レコードをリストとして取得
            List<Map<?, ?>> list = mappingIterator.readAll();
            System.out.println(list);
        } catch(Exception e) {
            e.printStackTrace();
        }
    }
}

コードのポイント

• CsvSchema.emptySchema().withHeader()：1行目をヘッダー（列名）として扱うスキーマを自動生成します。
• reader().forType(Map.class)：各行をキーと値のペアを持つMapオブジェクトとしてマッピングします。
• readValues()：MappingIteratorを返し、CSVのレコードを1行ずつ読み取れるようにします。
• readAll()：すべてのレコードを一括してListとして取得します。

実行結果

[{last name=Chandra, first name=Ravi, location=Bangalore}]

このように、JacksonのCsvMapperを活用すれば、数行のコードでCSVデータを簡単にJSON形式へ変換できます。大規模なCSVファイルを扱う場合も、MappingIteratorによる逐次読み込みを組み合わせることで、メモリ効率の良い処理が可能になります。