JavaにおけるJSONObjectのaccumulate()メソッドの重要性とは？

JSONObjectは、名前（キー）と値のペアからなる順序を持たないコレクションです。JSONArrayには、accumulate()、put()、opt()、append()、write()など、さまざまな便利なメソッドが用意されています。

accumulate()メソッドは、指定したキーの下に値を順次蓄積していくためのメソッドです。基本的な使い方はput()メソッドと似ていますが、決定的に異なるのは、同じキーにすでに値が存在する場合の挙動です。accumulate()を使用すると、そのキーの下に自動的にJSONArrayが生成され、蓄積された複数の値がすべて格納されます。さらに、すでにJSONArrayが存在するキーに対して呼び出した場合は、その配列に新しい値が追加されていきます。

構文

public JSONObject accumulate(java.lang.String key, java.lang.Object value) throws JSONException

put()メソッドとの違い

put()メソッドで同じキーに再度値を設定すると、既存の値は上書きされます。一方、accumulate()メソッドは既存の値を保持したまま、新しい値を配列形式で追加していきます。そのため、1つのキーに複数の値を関連付けたい場合に非常に有効なメソッドです。

使用例

import org.json.*;

public class JSONAccumulateMethodTest {
    public static void main(String[] args) throws JSONException {
        JSONObject jsonObj = new JSONObject();
        jsonObj.accumulate("Technology", "Java");
        jsonObj.accumulate("Technology", "Python");
        jsonObj.accumulate("Technology", "Spark");
        jsonObj.accumulate("Technology", "Selenium");
        jsonObj.accumulate("Technology", ".Net");
        System.out.println(jsonObj.toString(3));
    }
}

実行結果

{"Technology": [
    "Java",
    "Python",
    "Spark",
    "Selenium",
    ".Net"
]}