Jolt教程：用shift拆解数组生成对象

本文深入剖析了 Jolt 中 `shift` 操作处理 JSON 数组时的关键陷阱与正确范式，聚焦于如何在完整保留 `steps` 数组的同时，精准提取首个元素的 `start` 和 `end` 字段并构造成独立的 `date` 结构；通过揭示通配符 `*` 与索引 `"0"` 在路径匹配中的作用域差异、纠正常见的嵌套误写（如 `"steps": { "0": {...} }` 的失效根源），展示了以 `"*": { "@": "&1" }` 为核心的安全透传机制，并提供了经过验证的可运行 Spec 及逐层解析——帮你真正理解 Jolt 不是写代码而是做路径映射，从而稳健应对复杂 JSON 结构重组需求。

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

好了，本文到此结束，带大家了解了《Jolt教程：用shift拆解数组生成对象》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！