Jolt 转换：如何将扁平 JSON 结构转换为嵌套数组格式

在数据处理和转换过程中，我们经常需要将简单的扁平 JSON 结构转换为更复杂的嵌套格式。本文将通过一个实际案例，展示如何使用 Jolt 库实现这种转换。

原始数据结构分析

我们有以下简单的 JSON 输入：

{
  "id": "INC-199",
  "name": "Test Incident",
  "category": "SERVER"
}

这个数据结构包含三个字段：

• id：事件编号
• name：事件名称
• category：事件分类

目标数据结构

我们需要将其转换为以下格式：

{
  "cxid": "INC-199",
  "cispec": [
    {
      "assetattrid": "CX_NAME",
      "alnvalue": "Test Incident"
    },
    {
      "assetattrid": "CX_CATEGORY",
      "alnvalue": "SERVER"
    }
  ]
}

转换后的数据结构特点：

1. id 字段被重命名为 cxid
2. name 和 category 字段被放入 cispec 数组中
3. 每个数组元素包含两个字段：
   • assetattrid：固定的标识符（CX_NAME 或 CX_CATEGORY）
   • alnvalue：原始字段的值

Jolt 转换方案实现

为了实现这种转换，我们使用了两步 Jolt 转换：

第一步：初步转换

[
  {
    "operation": "shift",
    "spec": {
      "id": "cxid",
      "name": {
        "#CX_NAME": "&1.cispec.assetattrid",
        "@0": "&1.cispec.alnvalue"
      },
      "category": {
        "#CX_CATEGORY": "&1.cispec.assetattrid",
        "@0": "&1.cispec.alnvalue"
      }
    }
  }
]

这一步的关键点：

1. 直接映射 id 到 cxid
2. 对 name 和 category 字段进行特殊处理：
   • 使用 # 符号添加固定值（CX_NAME 和 CX_CATEGORY）
   • 使用 @0 引用当前字段的值
   • &1 表示匹配的字段名（name 或 category）

第二步：数组化处理

{
  "operation": "shift",
  "spec": {
    "*": "&",
    "name|category": {
      "*": "cispec[]"
    }
  }
}

这一步的关键点：

1. "*": "&" 保留所有非 name/category 的字段
2. 将 name 和 category 下的所有内容放入 cispec 数组

简化方案

经过分析，我们可以将上述两步合并为一个更简洁的方案：

[
  {
    "operation": "shift",
    "spec": {
      "id": "cxid",
      "name": {
        "#CX_NAME": "cispec[0].assetattrid",
        "@": "cispec[0].alnvalue"
      },
      "category": {
        "#CX_CATEGORY": "cispec[1].assetattrid",
        "@": "cispec[1].alnvalue"
      }
    }
  }
]

这个简化方案直接指定了数组索引，避免了第二步的处理，使转换更加直观。

技术要点总结

1. 字段重命名：使用简单的键值对映射实现字段重命名
2. 固定值插入：使用 # 符号可以插入固定字符串
3. 数组构建：通过 [n] 索引或 [] 自动索引构建数组结构
4. 条件处理：通过 | 符号可以匹配多个字段名
5. 引用原始值：@ 符号用于引用输入中的原始值

这种转换模式在 API 数据格式标准化、系统间数据交换等场景中非常有用，能够帮助开发者灵活地处理不同系统间的数据结构差异。

通过这个案例，我们可以看到 Jolt 转换的强大之处在于它能够通过声明式的 JSON 配置完成复杂的数据结构转换，而无需编写繁琐的代码逻辑。