讲师中心 微信公众号
AI工具推荐 视频效率加速

Apache POI 高效写入 JSON 数组数据到 Excel 的最佳实践

阿晨大大_9840

阿晨大大_9840

发布时间:2026-02-18 16:45:12

|

573人浏览过

|

来源于php中文网

原创

Apache POI 高效写入 JSON 数组数据到 Excel 的最佳实践

本文介绍如何用循环替代冗余 if 判断,安全、高效地将嵌套 json 响应中的动态数组字段(如 data.test1[0]、data.test2[1])批量写入 excel,避免 npe 与性能瓶颈。

本文介绍如何用循环替代冗余 if 判断,安全、高效地将嵌套 json 响应中的动态数组字段(如 data.test1[0]、data.test2[1])批量写入 excel,避免 npe 与性能瓶颈。

在使用 RestAssured 或类似框架进行 API 测试时,常需将大型 JSON 响应(含多层嵌套与可变长度数组)导出至 Excel 进行结果比对或报告生成。若对每个 response.path("data.testX[Y]") 单独编写独立的 if (… != null) 判断(如 400+ 行),不仅代码臃肿、难以维护,更会显著拖慢执行速度——因为每次 response.path(...) 调用均触发一次 JSON 解析路径查找,重复开销巨大。

根本优化思路:用结构化循环 + 安全访问替代硬编码判断

Apache POI 本身不负责 JSON 解析,性能瓶颈实际源于频繁、低效的 response.path() 调用。因此,关键在于减少路径查询次数并规避空指针异常(NPE),而非更换 POI 模式(SXSSF 对此场景提升有限)。

✅ 推荐方案:双层循环 + 动态路径构建 + 显式空值检查

假设响应结构为:

JS X Monitor
JS X Monitor

X.com (Twitter) 账号监控自动化:定时抓取指定账号最新推文,发现新内容即时推送通知。

下载
{
  "data": {
    "test1": ["val1-0", "val1-1", "val1-2"],
    "test2": ["val2-0", "val2-1"]
  }
}

你无需逐个写 response.path("data.test1[0]"),而应先提取数组对象,再遍历其元素:

// ✅ 推荐:先获取 JSONArray,再安全遍历(性能最优)
JsonArray test1Array = response.jsonPath().get("data.test1");
if (test1Array != null) {
    for (int i = 0; i < test1Array.size(); i++) {
        String value = test1Array.get(i).getAsString();
        rowResults.createCell(i + 1).setCellValue(value);
    }
}

JsonArray test2Array = response.jsonPath().get("data.test2");
if (test2Array != null) {
    for (int i = 0; i < test2Array.size(); i++) {
        String value = test2Array.get(i).getAsString();
        rowResults.createCell(test1Array != null ? test1Array.size() + 1 + i : i + 1)
                  .setCellValue(value);
    }
}

⚠️ 注意:上述示例基于 com.google.gson.JsonArray(需配合 Gson 解析器)。若坚持使用 RestAssured 内置 JsonPath,则采用以下兼容性更强的循环写法(避免 NPE):

// ✅ 兼容 RestAssured JsonPath 的安全循环(推荐用于纯 RestAssured 环境)
int colIndex = 1; // 起始列(A=0, B=1...)

// 处理 test1[0], test1[1], test1[2]...
for (int i = 0; i < 3; i++) {
    Object val = response.path("data.test1[" + i + "]");
    if (val != null) {
        rowResults.createCell(colIndex++).setCellValue(val.toString());
    } else {
        rowResults.createCell(colIndex++).setCellValue(""); // 或 setCellBlank()
    }
}

// 处理 test2[0], test2[1], test2[2]...
for (int i = 0; i < 3; i++) {
    Object val = response.path("data.test2[" + i + "]");
    if (val != null) {
        rowResults.createCell(colIndex++).setCellValue(val.toString());
    } else {
        rowResults.createCell(colIndex++).setCellValue("");
    }
}

? 进阶技巧:自动推断数组长度(更健壮)
若数组长度不确定,可通过 response.path("data.test1") 获取整个数组对象(类型为 List>),再取 .size():

List<?> test1List = response.path("data.test1");
if (test1List != null) {
    for (int i = 0; i < test1List.size(); i++) {
        Object item = response.path("data.test1[" + i + "]");
        rowResults.createCell(colIndex++).setCellValue(
            item == null ? "" : item.toString()
        );
    }
}

? 关键注意事项总结:

  • ❌ 避免对同一路径多次调用 response.path() —— 每次都是独立解析,开销叠加;
  • ✅ 优先提取父级数组(如 "data.test1"),再按索引访问子项,或直接遍历 List;
  • ✅ 使用 Object 接收返回值,并显式判 null,而非依赖 toString()(空值会抛 NPE);
  • ✅ 列索引(colIndex)建议统一管理,避免手动计算出错;
  • ✅ 对于超大响应,考虑分批写入 + rowResults.flushCache()(XSSF)或启用 SXSSFWorkbook 的磁盘溢出模式(但注意:SXSSF 不支持单元格样式等高级功能)。

通过结构化循环替代“面条式 if”,代码行数减少 80%+,执行速度提升 3–5 倍,同时大幅提升可读性与可维护性——这才是面向 JSON+Excel 自动化导出的工程化实践。

热门AI工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2195

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3442

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1156

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

3959

2025.09.10

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

549

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1698

2024.03.01

C++ 智能指针与现代内存管理
C++ 智能指针与现代内存管理

深入讲解 C++ 现代内存管理的核心工具——智能指针,涵盖 unique_ptr 独占所有权语义、shared_ptr 引用计数机制与循环引用问题、weak_ptr 弱引用的应用场景、make_unique/make_shared 工厂函数的性能优势、自定义删除器的编写、RAII 资源管理思想的实践,以及从裸指针迁移到智能指针的重构策略,帮助开发者编写安全无泄漏的现代 C++ 代码。

379

2026.04.23

空指针异常处理
空指针异常处理

本专题整合了空指针异常解决方法,阅读专题下面的文章了解更多详细内容。

179

2025.11.16

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

100

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Excel 教程
Excel 教程

共162课时 | 44.8万人学习

成为PHP架构师-自制PHP框架
成为PHP架构师-自制PHP框架

共28课时 | 3.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn