JavaでJSON-lib APIを使用して配列をJSONArrayに変換する方法

Javaの配列（Array）は、同じ型の複数の変数を格納するためのオブジェクトであり、プリミティブ型やオブジェクト参照を保持することができます。一方、JSONArrayは順序付けられた値のシーケンスです。その外部テキスト形式は、角括弧「[ ]」で囲まれ、値がカンマで区切られた文字列として表現されます。内部形式としては、インデックスを指定して値にアクセスするための get() メソッドおよび opt() メソッド、そして値を追加・置換するための element() メソッドを持つオブジェクトとして実装されています。

配列をJSONArrayに変換するには、まず Object[] 配列を作成し、それを引数として JSONSerializer クラスの toJSON() メソッドに渡します。その戻り値をJSONArrayにキャストすることで、JSON配列を取得できます。

サンプルコード

以下の例では、Object[] 配列を JSONArray に変換しています。

import net.sf.json.JSONArray;
import net.sf.json.JSONSerializer;

public class ConvertArrayToJSONArrayTest {
    public static void main(String[] args) {
        Object[] objArray = new Object[] {
            "Array to JSON Array",
            new Integer(10),
            new Long(30),
            new Double(14.26),
            true,
            new char[] {'X', 'Y', 'Z'}
        };

        JSONArray jsonArray = (JSONArray) JSONSerializer.toJSON(objArray);
        System.out.println(jsonArray.toString(3)); // 整形してJSONを出力
    }
}

実行結果

[
   "Array to JSON Array",
   10,
   30,
   14.26,
   true,
   [
      "X",
      "Y",
      "Z"
   ]
]

ポイント解説

• JSONSerializer.toJSON()：任意のJavaオブジェクトや配列を受け取り、JSON形式へ変換する静的メソッドです。
• toString(3)：引数にインデント幅を指定すると、見やすい整形済み（pretty print）のJSON文字列が出力されます。
• char型の配列は、自動的に文字列の配列としてJSON配列内に展開されます。
• このAPIを使用するには、クラスパスに json-lib のJARファイルが必要です。json-libは内部で commons-lang、commons-beanutils、commons-collections、ezmorph などのライブラリに依存しているため、併せて追加してください。