本文介绍使用 Jackson 库在 Java 中将 JSON 数组（如 "splits"）原地转换为多个命名字段（如 "sector1"、"sector2"），无需新建数据结构，保持原始对象扁平化。
本文介绍使用 jackson 库在 java 中将 json 数组（如 `"splits"`）原地转换为多个命名字段（如 `"sector1"`、`"sector2"`），无需新建数据结构，保持原始对象扁平化。
在处理赛车遥测、分段计时等场景时，常遇到类似结构：一个 JSON 对象中包含名为 "splits" 的数值数组，而业务逻辑更倾向于将每个分段值作为独立字段（如 "sector1"、"sector2"）直接暴露在顶层。此时，若强行引入新 POJO 类或中间封装对象，不仅增加维护成本，还会破坏现有数据流的简洁性。
Jackson 提供了高效的树模型（JsonNode / ObjectNode / ArrayNode）支持原地修改，完美契合该需求。核心思路是：遍历 JSON 数组，逐个提取元素，并以动态键名写入父对象，同时移除原数组字段。
以下为完整可执行示例（需引入 com.fasterxml.jackson.core:jackson-databind）：
import com.fasterxml.jackson.databind.*;
import com.fasterxml.jackson.databind.node.ArrayNode;
import com.fasterxml.jackson.databind.node.ObjectNode;
public class JsonSplitsFlattener {
public static JsonNode flattenSplits(JsonNode root) throws JsonProcessingException {
ObjectMapper mapper = new ObjectMapper();
// 假设输入是一个 JSON Array（含多个 lap 记录）
if (root.isArray()) {
root.forEach(card -> {
if (card.isObject()) {
ObjectNode cardObject = (ObjectNode) card;
JsonNode splitsNode = cardObject.get("splits");
// 安全检查：确保 splits 存在且为数组
if (splitsNode != null && splitsNode.isArray()) {
ArrayNode splits = (ArrayNode) splitsNode;
cardObject.remove("splits"); // 移除原数组
// 将每个 split 元素转为 sectorN 字段（索引从 0 开始 → sector1, sector2...）
for (int i = 0; i < splits.size(); i++) {
JsonNode value = splits.get(i);
// 自动适配数值类型：整数/浮点数均正确序列化
if (value.isNumber()) {
cardObject.put("sector" + (i + 1), value.asInt());
} else {
cardObject.put("sector" + (i + 1), value.asText());
}
}
}
}
});
}
return root;
}
// 使用示例
public static void main(String[] args) throws JsonProcessingException {
String jsonInput = """
[
{
"carId": 1001,
"driverIndex": 0,
"laptime": 173001,
"isValidForBest": false,
"splits": [91851, 52002, 29147]
},
{
"carId": 1001,
"driverIndex": 0,
"laptime": 107270,
"isValidForBest": true,
"splits": [26295, 51960, 29015]
}
]
""";
JsonNode rootNode = new ObjectMapper().readTree(jsonInput);
JsonNode flattened = flattenSplits(rootNode);
System.out.println(new ObjectMapper().writerWithDefaultPrettyPrinter().writeValueAsString(flattened));
}
}✅ 关键要点说明：
- 使用
cardObject.remove("splits")确保原字段被彻底清除，避免残留； -
sector编号从1开始（即sector1,sector2），符合常规语义，代码中通过(i + 1)实现； - 类型安全处理：对
isNumber()分支显式调用asInt()或asText()，避免put(String, JsonNode)在某些 Jackson 版本中引发不可预期行为； - 支持嵌套于 JSON 数组中处理多条记录，也兼容单个对象（只需调整外层判断逻辑）；
-
零额外对象创建：全程复用原有
ObjectNode，内存友好，与下游消费代码完全兼容。
该方法在不侵入业务模型、不新增类定义的前提下，实现了 JSON 结构的轻量级重构，特别适合 ETL 转换、API 响应适配及前端友好格式生成等场景。
