Jolt JSON转换：动态数组处理与数值类型到字符串的转换实践-java教程-PHP中文网

Jolt JSON转换：动态数组处理与数值类型到字符串的转换实践

心靈之曲

发布： 2025-09-21 10:37:19

原创

418人浏览过

Jolt JSON转换：动态数组处理与数值类型到字符串的转换实践

本文深入探讨了如何使用Jolt进行复杂的JSON数据转换，重点解决了动态数组的处理以及将数值类型字段转换为字符串类型的需求。通过详细分析shift操作进行结构重塑和数组整合，并引入modify-overwrite-beta操作结合toString函数，实现了精确的数据类型转换，为高效处理JSON数据提供了实用的解决方案。

1. Jolt简介与JSON数据转换挑战

jolt是一个强大的json到json转换库，它允许开发者通过定义一系列的转换规则（jolt spec）来重塑、过滤、修改json数据。在处理实际业务场景时，我们经常会遇到需要将复杂的、嵌套的json结构转换为另一种格式，同时可能伴随着字段重命名、数据过滤、甚至数据类型转换等需求。本教程将通过一个具体案例，演示jolt如何优雅地处理这些挑战，特别是针对动态数组和数值类型到字符串的转换。

2. 场景分析：动态数组与数据类型转换需求

假设我们有一个包含实体信息和动态照片列表的输入JSON，我们的目标是将其转换为一个更扁平、结构化的输出，并且要求照片ID (Id) 在输出中以字符串形式 (no) 存在。

原始输入JSON：

{
  "Entity": {
    "card": {
     "cardNo":"123456789",
      "cardStatus":"10",
      "cardAddress":"UK",
      "cardAddress1":"US",
      "cardCity":"mk" ,
       "name": "RAM",
      "lastName": "ABU",
       "name1": "RAM1",
      "lastName1": "ABU1"
    },
    "Photos": [
      {
        "Id": 327703,
        "Caption": "TEST>> photo 1",
        "Url": "http://bob.com/0001/327703/photo.jpg"
      },
      {
        "Id": 327704,
        "Caption": "TEST>> photo 2",
        "Url": "http://bob.com/0001/327704/photo.jpg"
      },
      {
        "Id": 327704,
        "Caption": "TEST>> photo 2",
        "Url": "http://bob.com/0001/327704/photo.jpg"
      }
    ]
  }
}

登录后复制

期望输出JSON：

注意 Photos 数组中 no 字段的值，它们现在是字符串类型。

{
  "tab": {
    "text": "123456789"
  },
  "address": [
    {
      "add": "UK",
      "add2": "US",
      "mk": "mk"
    }
  ],
  "Photos": [
    {
      "caption2": "http.1.com",
      "no": "222444"
    },
    {
      "caption2": "http.2.com",
      "no": "222444"
    },
    {
      "caption2": "TEST>> photo 1",
      "no": "327703"
    },
    {
      "caption2": "TEST>> photo 2",
      "no": "327704"
    },
    {
      "caption2": "TEST>> photo 2",
      "no": "327704"
    }
  ]
}

登录后复制

3. Jolt转换核心操作详解

为了实现上述转换，我们将分三个阶段使用Jolt的shift和modify-overwrite-beta操作。

3.1 第一阶段：结构重塑与字段映射 (shift 操作)

这个阶段主要负责将输入JSON的 Entity.card 和 Entity.Photos 部分映射到目标结构中的 tab、address 和 Photos。

[
  {
    "operation": "shift",
    "spec": {
      "Entity": {
        "card": {
          "cardNo": "tab.text",
          "cardAddress": "address[0].add",
          "cardAddress1": "address[0].add2",
          "cardC*": "address[0].mk",
          "Id1": "Photos.no",
          "#http.1.com": "Photos.caption2",
          "Id2": "Photos.no",
          "#http.2.com": "Photos.caption2"
        },
        "Photos": {
          "*": {
            "Id": "Photos.no",
            "Caption": "Photos.caption2"
          }
        }
      }
    }
  }
]

登录后复制

解释：

怪兽AI数字人

数字人短视频创作，数字人直播，实时驱动数字人

查看详情

Entity.card 下的字段被映射到 tab.text 和 address[0] 下的对应字段。cardC* 使用通配符匹配 cardCity。
Id1, #http.1.com, Id2, #http.2.com 这些是原问题中可能存在的额外映射，它们将生成额外的 Photos 数组元素。
Entity.Photos 数组中的每个元素 (*)，其 Id 字段被映射到 Photos.no，Caption 字段被映射到 Photos.caption2。
- 注意：此阶段的 Photos 映射会将所有 Photos 数组元素扁平化，并与 card 部分生成的 Photos 元素合并，导致 Photos 数组可能包含重复或结构不完全一致的元素。

3.2 第二阶段：数组元素整合 (shift 操作)

由于第一阶段的 shift 操作可能导致 Photos 数组中的元素结构不一致或扁平化，我们需要第二个 shift 操作来重新组织和整合 Photos 数组，确保其结构正确。

[
  {
    "operation": "shift",
    "spec": {
      "Entity": {
        "card": {
          "cardNo": "tab.text",
          "cardAddress": "address[0].add",
          "cardAddress1": "address[0].add2",
          "cardC*": "address[0].mk",
          "Id1": "Photos.no",
          "#http.1.com": "Photos.caption2",
          "Id2": "Photos.no",
          "#http.2.com": "Photos.caption2"
        },
        "Photos": {
          "*": {
            "Id": "Photos.no",
            "Caption": "Photos.caption2"
          }
        }
      }
    }
  },
  {
    "operation": "shift",
    "spec": {
      "tab": "&",
      "address": "&",
      "Photos": {
        "*": {
          "*": {
            "@": "&3[&1].&2"
          }
        }
      }
    }
  }
]

登录后复制

解释：

"tab": "&" 和 "address": "&"：这些规则将前一个 shift 操作生成的 tab 和 address 结构原样保留。& 是一个通配符，表示将当前键 (tab 或 address) 作为输出路径。
"Photos": { "*": { "*": { "@": "&3[&1].&2" } } }：这是关键的数组整合部分。
- "Photos"：匹配 Photos 数组。
- "*" (第一个)：匹配 Photos 数组中的每个元素（例如 Photos[0], Photos[1] 等）。
- "*" (第二个)：匹配每个数组元素内部的键（例如 no, caption2）。
- "@": "&3[&1].&2"：
  - @：表示取当前匹配到的值。
  - &3：回溯三级，即 Photos 这个键。
  - [&1]：回溯一级，即当前数组元素的索引。这确保了每个元素保持在 Photos 数组中的正确位置。
  - .&2：回溯二级，即当前键（no 或 caption2）。
  - 综合起来，这条规则将 Photos 数组中的每个键值对 (Photos[i].key: value) 重新映射回 Photos[i].key: value，有效地整合了可能被扁平化的 Photos 元素，并去除了第一阶段中不必要的 Photos 键。

经过这两个 shift 操作后，输出将是：

{
  "tab": {
    "text": "123456789"
  },
  "address": [
    {
      "add": "UK",
      "add2": "US",
      "mk": "mk"
    }
  ],
  "Photos": [
    {
      "caption2": "http.1.com",
      "no": 222444
    },
    {
      "caption2": "http.2.com",
      "no": 222444
    },
    {
      "caption2": "TEST>> photo 1",
      "no": 327703
    },
    {
      "caption2": "TEST>> photo 2",
      "no": 327704
    },
    {
      "caption2": "TEST>> photo 2",
      "no": 327704
    }
  ]
}

登录后复制

此时，no 字段仍然是数值类型。

3.3 第三阶段：数据类型转换 (modify-overwrite-beta 操作)

为了将 Photos 数组中 no 字段的数值类型转换为字符串类型，我们需要使用 modify-overwrite-beta 操作和 toString 函数。

,
{
  "operation": "modify-overwrite-beta",
  "spec": {
    "Photos": {
      "*": {
        "no": "=toString"
      }
    }
  }
}

登录后复制

解释：

"operation": "modify-overwrite-beta"：这是一个修改操作，它会根据 spec 中定义的规则修改现有值。overwrite-beta 表示如果目标路径存在，则覆盖其值。
"Photos": { "*": { "no": "=toString" } }：
- "Photos"：定位到 Photos 数组。
- "*"：匹配 Photos 数组中的所有元素（即 Photos[0], Photos[1] 等）。
- "no"：定位到每个数组元素中的 no 字段。
- "=toString"：这是一个Jolt函数调用。它会获取 no 字段的当前值，并将其转换为字符串类型，然后将转换后的字符串值写回 no 字段。

4. 完整Jolt Spec与最终效果

将上述三个阶段的Jolt Spec组合起来，就得到了完整的转换规则：

[
  {
    "operation": "shift",
    "spec": {
      "Entity": {
        "card": {
          "cardNo": "tab.text",
          "cardAddress": "address[0].add",
          "cardAddress1": "address[0].add2",
          "cardC*": "address[0].mk",
          "Id1": "Photos.no",
          "#http.1.com": "Photos.caption2",
          "Id2": "Photos.no",
          "#http.2.com": "Photos.caption2"
        },
        "Photos": {
          "*": {
            "Id": "Photos.no",
            "Caption": "Photos.caption2"
          }
        }
      }
    }
  },
  {
    "operation": "shift",
    "spec": {
      "tab": "&",
      "address": "&",
      "Photos": {
        "*": {
          "*": {
            "@": "&3[&1].&2"
          }
        }
      }
    }
  },
  {
    "operation": "modify-overwrite-beta",
    "spec": {
      "Photos": {
        "*": {
          "no": "=toString"
        }
      }
    }
  }
]

登录后复制

应用这个完整的Jolt Spec，将得到符合期望的输出，其中 Photos 数组中的 no 字段值已成功转换为字符串类型。

5. 总结与注意事项

Jolt的灵活性：Jolt通过链式操作（多个转换阶段）提供了强大的JSON转换能力，可以应对从结构重塑到数据类型转换的各种复杂需求。
shift操作：主要用于重塑JSON结构、重命名字段、提取特定数据。在处理数组时，需要注意其扁平化行为，并可能需要额外的shift操作进行整合。
modify-overwrite-beta操作：是进行值修改和数据类型转换的关键。它允许你使用内置函数（如=toString、=toInteger、=toDouble等）来处理字段的值。
*通配符 (`) 和回溯 (&)**：在处理动态数组或复杂嵌套结构时，*和&` 是非常强大的工具，它们使得Jolt Spec能够适应不确定数量的元素和动态路径。
操作链顺序：Jolt的操作是按顺序执行的。确保操作的逻辑顺序正确，前一个操作的输出是后一个操作的输入。在这个案例中，先进行结构重塑和整合，最后进行类型转换，是符合逻辑的。