Java中如何向JSONObject头部插入新键值对且无需对key排序

JSON 规范本身不约定键的存储顺序，因此绝大多数JSON库没有内置prepend这类前置插入的API，结合你无法预先知晓现有key、不能通过排序实现的需求，可以通过「新建有序JSON对象优先插入目标键值对，再追加原有所有键值对」的方式实现，不需要依赖已知key或排序操作。

针对org.json库（常用官方JSON库） #

2019年及之后发布的org.json版本，JSONObject内部默认使用LinkedHashMap存储数据，会严格保留插入顺序，实现代码如下：

import org.json.JSONObject;
import java.util.Iterator;

public class JsonPrependExample {
    public static JSONObject prependKeyValue(JSONObject originalJson, String newKey, Object newValue) {
        // 新建空JSONObject
        JSONObject newJson = new JSONObject();
        // 优先插入需要前置的键值对
        newJson.put(newKey, newValue);
        // 按原有顺序遍历原JSONObject的所有键值对，追加到新对象
        Iterator<String> keyIterator = originalJson.keys();
        while (keyIterator.hasNext()) {
            String key = keyIterator.next();
            newJson.put(key, originalJson.get(key));
        }
        return newJson;
    }

    public static void main(String[] args) {
        // 示例原有JSON
        JSONObject original = new JSONObject("{\"one\":1,\"two\":2,\"three\":3,\"four\":4,\"five\":5}");
        // 调用方法前置插入zero:0
        JSONObject result = prependKeyValue(original, "zero", 0);
        // 格式化输出验证
        System.out.println(result.toString(4));
    }
}

针对FastJSON库 #

FastJSON的JSONObject默认同样按插入顺序存储，实现逻辑和上述一致，仅需替换对应的API即可：

import com.alibaba.fastjson.JSONObject;
import java.util.Map;

public class FastJsonPrependExample {
    public static JSONObject prependKeyValue(JSONObject originalJson, String newKey, Object newValue) {
        JSONObject newJson = new JSONObject();
        newJson.put(newKey, newValue);
        for (Map.Entry<String, Object> entry : originalJson.entrySet()) {
            newJson.put(entry.getKey(), entry.getValue());
        }
        return newJson;
    }
}

注意事项 #

• 若你使用的是2019年之前的老版本org.json库，内部默认使用无序的HashMap存储，无法保证顺序，需要升级org.json依赖到高版本，或更换为有序JSON库。
• 若你需要将处理后的JSON传递给第三方系统，请确认对方的JSON解析逻辑也会保留键顺序，否则顺序调整在对方侧可能失效。

内容的提问来源于stack exchange，提问作者KANAYO AUGUSTIN UG