本文介绍如何将键名含多级路径（如 `"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 坐标：json20250303），无反射/注解/运行时代理开销。

⚠️ 注意事项与建议：

• 键冲突处理：当前实现允许后写覆盖（如重复 "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  # js  # json  # node  # app  # 栈  # ai  # 键值对  # maven  # String  # Object  # if  # throw  # 字符串  # 递归  # 循环  # 接口  # Length  # map  # 对象  # 重构  # 低代码  # 遍历  # 键值  # 扁平化  # 键名  # 在此  # 设为  # 适用于  # 这类  # 可在 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： JavaScript如何操作视频_媒体API怎么控制播放  如何在腾讯云免费申请建站？  Bootstrap CSS布局之列表  Laravel怎么为数据库表字段添加索引以优化查询  Python自动化办公教程_ExcelWordPDF批量处理案例  如何在建站主机中优化服务器配置？  微信小程序 require机制详解及实例代码  打开php文件提示内存不足_怎么调整php内存限制【解决方案】  百度输入法ai组件怎么删除 百度输入法ai组件移除工具  三星、SK海力士获美批准：可向中国出口芯片制造设备  Laravel如何创建和注册中间件_Laravel中间件编写与应用流程  Laravel定时任务怎么设置_Laravel Crontab调度器配置  Laravel怎么实现模型属性转换Casting_Laravel自动将JSON字段转为数组【技巧】  Python企业级消息系统教程_KafkaRabbitMQ高并发应用  教你用AI将一段旋律扩展成一首完整的曲子  Laravel如何编写单元测试和功能测试？（PHPUnit示例）  Laravel项目如何进行性能优化_Laravel应用性能分析与优化技巧大全  Laravel Fortify是什么，和Jetstream有什么关系  高性能网站服务器配置指南：安全稳定与高效建站核心方案  为什么php本地部署后css不生效_静态资源加载失败修复技巧【技巧】  Laravel Livewire是什么_使用Laravel Livewire构建动态前端界面  网站建设保证美观性，需要考虑的几点问题！  微信小程序制作网站有哪些,微信小程序需要做网站吗？  大型企业网站制作流程,做网站需要注册公司吗？  Laravel如何操作JSON类型的数据库字段？（Eloquent示例）  Laravel中的withCount方法怎么高效统计关联模型数量  Laravel如何与Vue.js集成_Laravel + Vue前后端分离项目搭建指南  使用C语言编写圣诞表白程序  EditPlus中的正则表达式 实战(4)  谷歌Google入口永久地址_Google搜索引擎官网首页永久入口  详解jQuery中的事件  制作旅游网站html,怎样注册旅游网站？  Edge浏览器怎么启用睡眠标签页_节省电脑内存占用优化技巧  今日头条微视频如何找选题 今日头条微视频找选题技巧【指南】  Laravel如何与Inertia.js和Vue/React构建现代单页应用  Laravel怎么在Blade中安全地输出原始HTML内容  如何在阿里云香港服务器快速搭建网站？  如何在宝塔面板中修改默认建站目录？  JavaScript模板引擎Template.js使用详解  BootStrap整体框架之基础布局组件  胶州企业网站制作公司,青岛石头网络科技有限公司怎么样？  高防服务器租用如何选择配置与防御等级？  微博html5版本怎么弄发超话_超话进入入口及发帖格式要求【教程】  Laravel用户密码怎么加密_Laravel Hash门面使用教程  网站建设整体流程解析，建站其实很容易！  Laravel怎么创建自己的包(Package)_Laravel扩展包开发入门到发布  简单实现Android验证码  如何在阿里云部署织梦网站？  Laravel N+1查询问题如何解决_Eloquent预加载(Eager Loading)优化数据库查询  如何在搬瓦工VPS快速搭建网站？