JavaでリストをJSON配列に変換する方法をわかりやすく解説

JSONは、軽量でテキストベース、かつ言語に依存しないデータ交換フォーマットです。JSONでは、「オブジェクト」と「配列」という2種類の構造化データを表現できます。オブジェクトはキーと値のペアからなる順序を持たないコレクションであり、配列は値が順序付けられたシーケンスです。

Javaでリスト（List）をJSON配列に変換するには、JSONArray.toJSONString()メソッドを使用します。このメソッドはJSONArrayクラスの静的（static）メソッドであり、引数として渡されたリストをJSON形式のテキストに変換し、その結果をJSON配列として返します。

なお、このメソッドを利用するには、org.json.simpleパッケージを提供する「json-simple」ライブラリが必要です。Mavenプロジェクトの場合は、pom.xmlに依存関係を追加しておきましょう。

構文

public static java.lang.String toJSONString(java.util.List list)

サンプルコード

import java.util.*;
import org.json.simple.*;

public class ConvertListToJSONArrayTest {
    public static void main(String[] args) {
        List<String> list = new ArrayList<String>();
        list.add("India");
        list.add("Australia");
        list.add("England");
        list.add("South Africa");
        list.add("West Indies");
        list.add("Newzealand");

        // このメソッドでリストをJSON配列に変換する
        String jsonStr = JSONArray.toJSONString(list);
        System.out.println(jsonStr);
    }
}

実行結果

["India","Australia","England","South Africa","West Indies","Newzealand"]

このように、toJSONString()メソッドにリストを渡すだけで、各要素がダブルクォートで囲まれた文字列として、カンマ区切りのJSON配列形式に変換されます。APIレスポンスの生成や設定ファイルの出力など、さまざまな場面で活用できる便利な手法なので、ぜひ覚えておきましょう。