Java实现JSON路径键扁平化转嵌套

本文深入讲解了如何在 Java 中将键名含点号分隔路径（如 `"employee1.address.street"`）的扁平化 JSON 数组，动态、安全地转换为符合语义的嵌套 JSON 对象结构——无需依赖 Jackson 或 Gson 等重量级框架，仅用轻量的 `org.json` 库即可实现任意深度路径解析、自动中间对象创建、强类型校验与清晰异常提示；代码简洁健壮、开箱即用，特别适合处理配置导出、遗留系统接口或低代码平台产生的非标准 JSON 数据，是开发者应对现实世界 JSON 结构混乱问题的实用利器。

本文介绍如何将键名含多级路径（如 `"employee1.address.street"`）的扁平化 JSON 数组，动态重构为标准嵌套 JSON 对象，支持任意深度路径，并提供基于 `org.json` 的健壮、可扩展实现方案。

在实际 Java 开发中，我们常需处理非标准 JSON 输入——例如键名以点号分隔、隐含层级关系但数据却以扁平数组形式组织。这类结构虽不规范，却常见于配置导出、遗留系统接口或低代码平台输出中。本文提供的解决方案不依赖外部高级框架（如 Jackson 注解或 Gson TypeAdapter），而是采用轻量、通用的 org.json:json（即 JSON-Java）库，通过递归路径解析实现任意深度的动态嵌套构建。

核心逻辑分为两步：

1. 遍历输入 JSONArray：每个元素为仅含一个键值对的 JSONObject；
2. 按 . 拆分键路径：逐级导航目标 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)); // 格式化缩进输出
    }
}

✅ 关键特性说明：

• 无限深度支持：split("\\.") + 循环导航天然适配 a.b.c.d.e 等任意长度路径；
• 自动嵌套创建：遇到不存在的中间键（如 "address" 或 "tempAddress"）时，自动新建 JSONObject；
• 强类型安全：对已存在但类型不符的键（如本应是对象却被设为字符串）抛出明确异常；
• 零依赖：仅需 org.json:json（Maven 坐标：json20240303），无反射/注解/运行时代理开销。

⚠️ 注意事项与建议：

• 键冲突处理：当前实现允许后写覆盖（如重复 "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()），但本文所给实现以最小依赖、最大透明度，成为快速落地的首选。

本篇关于《Java实现JSON路径键扁平化转嵌套》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！