Jolt 转换库中修改 JSON 键名的技术实现

在 JSON 数据处理过程中，经常需要对键名进行修改或转换。本文将以 Jolt 转换库为例，详细介绍如何通过 modify-overwrite-beta 操作实现 JSON 对象键名的批量修改。

问题背景

假设我们有一个 JSON 对象，其 attributes 属性下包含多个以 "ABC_" 为前缀的键值对。我们的目标是将这些键名中的 "ABC_" 前缀去除，仅保留后面的部分。

原始数据示例：

{
   "attributes": {
       "ABC_BCKHL": "123",
       "ABC_DHBLD": "234",
       "ABC_KKCAJ": "345"
   }
}

期望输出：

{
   "attributes": {
       "BCKHL": "123",
       "DHBLD": "234",
       "KKCAJ": "345"
   }
}

技术难点

在 Jolt 转换中，直接修改键名是一个常见的挑战，因为 Jolt 的设计初衷主要是处理值而非键。我们需要采用间接的方法来实现这一需求。

解决方案

三阶段转换法

1. 键值交换阶段
   首先使用 shift 操作将键和值互换，这样原来的键就变成了值，可以被后续操作处理。

2. 字符串处理阶段
   使用 modify-overwrite-beta 操作对新的值（即原来的键）应用 substring 函数，去除前缀。

3. 还原结构阶段
   再次使用 shift 操作将键值对还原到原始结构。

具体实现

[
  {
    "operation": "shift",
    "spec": {
      "attributes": {
        "*": {
          "$": "@0"
        }
      }
    }
  },
  {
    "operation": "modify-overwrite-beta",
    "spec": {
      "*": "=substring(@0,4,9)"
    }
  },
  {
    "operation": "shift",
    "spec": {
      "*": {
        "$": "attributes.@0"
      }
    }
  }
]

技术细节解析

1. 第一阶段 shift 操作

   • 通过 "$": "@0" 将键名作为值存储
   • 结果会变成类似 {"ABC_BCKHL":"ABC_BCKHL"} 的结构

2. 第二阶段 modify-overwrite-beta 操作

   • 使用 =substring(@0,4,9) 从第4个字符开始截取（索引从0开始）
   • 这里假设所有键都有相同的 "ABC_" 前缀结构

3. 第三阶段 shift 操作

   • 将处理后的键名还原为新的键
   • 同时保持原始值的关联关系

注意事项

1. 索引计算需要精确，确保截取位置正确
2. 此方法适用于所有键都有相同前缀的情况
3. 如果键名长度不一致，需要调整 substring 参数
4. 对于更复杂的键名转换，可能需要结合正则表达式等其他操作

总结

通过 Jolt 的三阶段转换法，我们成功实现了 JSON 键名的批量修改。这种方法虽然略显复杂，但充分利用了 Jolt 提供的各种操作组合，展现了 Jolt 在处理复杂 JSON 转换时的灵活性。对于类似的需求，开发者可以借鉴这种思路，通过分解问题、分步处理的方式实现目标。