
本文详解如何通过 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 实现安全透传。掌握此模式,即可稳健构建多层级、多来源的输出结构。









