本文介绍如何将键名含多级路径（如 `"employee1.address.street"`）的扁平化 json 数组，动态重构为标准嵌套 json 对象，支持任意深度路径，并提供基于 `org.json` 的健壮、可扩展实现方案。
在实际 Java 开发中，我们常需处理非标准 JSON 输入——例如键名以点号分隔、隐含层级关系但数据却以扁平数组形式组织。这类结构虽不规范，却常见于配置导出、遗留系统接口或低代码平台输出中。本文提供的解决方案不依赖外部高级框架（如 Jackson 注解或 Gson TypeAdapter），而是采用轻量、通用的 org.json:json（即 JSON-Java）库，通过递归路径解析实现任意深度的动态嵌套构建。
核心逻辑分为两步：
- 遍历输入 JSONArray：每个元素为仅含一个键值对的 JSONObject；
- 按 . 拆分键路径：逐级导航目标 JSONObject，自动创建缺失中间对象，最终将值写入叶子节点。
以下是完整可运行的实现：
import org.json.*;
public class JsonPathFlattener {
public static JSONObject flattenToNested(JSONArray inputArray) {
JSONObject result = new JSONObject();
for (Object item : inputArray) {
if (!(item instanceof JSONObject)) continue;
JSONObject entry = (JSONObject) item;
if (entry.length() != 1) {
throw new IllegalArgumentException("Each object must contain exactly one key-value pair");
}
String key = entry.keys().next();
Object value = entry.get(key);
setJsonPath(result, key, value);
}
return result;
}
private static void setJsonPath(JSONObject target, String path, Object value) {
String[] parts = path.split("\\.");
JSONObject current = target;
// 遍历路径前 N-1 段，构建中间嵌套对象
for (int i = 0; i < parts.length - 1; i++) {
String part = parts[i];
if (!current.has(part)) {
current.put(part, new JSONObject());
}
Object next = current.get(part);
if (!(next instanceof JSONObject)) {
throw new IllegalArgumentException(
"Path conflict: '" + part + "' already exists as non-JSONObject (value: " + next + ")");
}
current = (JSONObject) next;
}
// 设置最后一段为最终值（支持覆盖，如需冲突检测可在此加校验）
String lastKey = parts[parts.length - 1];
current.put(lastKey, value);
}
// 使用示例
public static void main(String[] args) {
String inputJson = """
[
{"employee1.id": 1},
{"employee1.name": "John"},
{"employee1.address.street": "main street"},
{"employee1.address.pin": "123456"},
{"employee2.id": 2},
{"employee2.name": "Mike"},
{"employee2.address.street": "51 street"},
{"employee2.address.pin": "234543"},
{"employee1.address.tempAddress.city": "Beijing"},
{"employee1.address.permanentAddress.city": "Shanghai"}
]
""";
JSONArray input = new JSONArray(inputJson);
JSONObject output = flattenToNested(input);
System.out.println(output.toString(2)); // 格式化缩进输出
}
}✅ 关键特性说明：
立即学习“Java免费学习笔记（深入）”；
- 无限深度支持：split("\\.") + 循环导航天然适配 a.b.c.d.e 等任意长度路径；
- 自动嵌套创建：遇到不存在的中间键（如 "address" 或 "tempAddress"）时，自动新建 JSONObject；
- 强类型安全：对已存在但类型不符的键（如本应是对象却被设为字符串）抛出明确异常；
-
零依赖：仅需 org.json:json（Maven 坐标：
json 20240303 ），无反射/注解/运行时代理开销。
⚠️ 注意事项与建议：
- 键冲突处理：当前实现允许后写覆盖（如重复 "employee1.id"），若业务要求严格一致性，可在 setJsonPath 中增加 if (current.has(lastKey)) { throw ... } 校验；
-
性能考量：适用于中等规模数据（千级键值对内）；若需极致性能且路径模式固定，可预编译路径树或改用 Map
+ Jackson ObjectMapper.convertValue() 组合； - 安全性提示：避免直接解析不可信输入——恶意超长路径可能引发栈溢出或内存耗尽，生产环境建议添加路径深度限制（如 if (parts.length > 10) throw new SecurityException(...)）。
该方案本质是将“字符串路径”映射为“对象引用链”，是 JSON 扁平化 ↔ 结构化转换的经典范式。掌握其原理后，亦可轻松迁移至 Jackson（配合 JsonNode.set() 和 withPath()）或 Gson（使用 JsonObject 递归 getAsJsonObject()），但本文所给实现以最小依赖、最大透明度，成为快速落地的首选。
