跳转到主内容
趣航编程网 - 趣学编程,启航技术之路!

Jolt 教程:使用 shift 操作将数组元素拆解并生成新结构对象

本文详解如何通过 jolt 的 `shift` 操作,正确地将输入 json 中的 `steps` 数组完整保留,同时提取首个元素的 `start` 和 `end` 字段,构造独立的 `date` 数组(含 `startdate`/`enddate` 对象)。重点纠正常见误用,提供可运行的规范 spec。 在使用 Jolt 进行 JSON 转换时,一个典型误区是混淆 shift 操作中通配符 * 与具体索引(如 "0")的匹配优先级与作用域。原 Spec 中的问题在于:
"steps": { "*": "steps[]", // ✅ 正确:将所有 steps 元素追加到输出 steps 数组 "0": { ... } // ❌ 冲突:该块被嵌套在 "steps" 下,但 "0" 是 steps[0] 的子路径,而非 steps 的直接子键 }
Jolt 的 shift 是 路径匹配驱动 的:"steps": { "0": { ... } } 实际尝试匹配 steps.0.start 这样的深层路径,而输入中 steps 是一个数组,其内部对象并无名为 "0" 的字段——因此该分支根本不会触发,导致 date 部分丢失;同时 "*": "steps[]" 在错误的作用域下也未能生效。 ✅ 正确思路是:* 将顶层键(如 "steps")作为通配符 ` 的匹配目标,再用@引用原始值,并用&1` 动态还原键名**。以下是经过验证的规范 Spec:
[ { "operation": "shift", "spec": { "*": { "@": "&1", "0": { "#startDate": "date[0].name", "start": "date[0].value", "#endDate": "date[1].name", "end": "date[1].value" } } } } ]
关键机制解析: "*" 匹配输入顶层所有键(此处为 "steps"); "@": "&1" 表示:将当前匹配键(&1 即 "steps")对应的整个值(即原数组)原样复制到输出同名键下 → 完整保留 steps 数组; "0" 是对 "steps" 数组 第一个元素对象 的进一步匹配(Jolt 自动支持数组索引路径),因此 "0": { "start": "date[0].value" } 能精准提取 steps[0].start; #startDate 是字面量字符串注入语法,用于硬编码字段值。 注意事项: 该 Spec 仅提取 steps[0] 的时间字段 ,符合需求;若需遍历全部 step 生成多个 date 条目,则需改用 modify-overwrite-beta 或 default 配合循环逻辑(Jolt 原生不支持数组映射循环); &1 中的数字表示层级引用:&0 = 当前匹配键,&1 = 上一级键(即顶层键),务必结合路径深度理解; 所有数组索引(如 date[0], steps[])必须显式声明,Jolt 不会自动推断数组扩容。 总结: Jolt 的 shift 操作本质是“路径重定向 + 值搬运”,而非编程式迭代。处理“保留原数组 + 提取特定索引字段”这类混合需求时,应避免将数组索引规则("0")错误嵌套在父键结构内,而应利用通配符 * 提升作用域,再通过 @ 和 &1 实现安全透传。掌握此模式,即可稳健构建多层级、多来源的输出结构。

相关文章