本文介绍如何利用 JSONata 的 transform 操作符（~>）精准定位并替换 JSON 中任意嵌套路径的值，以 Account.OrderID 为例，展示从读取到写入的完整数据变更流程。
本文介绍如何利用 jsonata 的 transform 操作符（`~>`）精准定位并替换 json 中任意嵌套路径的值，以 `account.orderid` 为例，展示从读取到写入的完整数据变更流程。
JSONata 本身是一个声明式查询与转换语言，原生不支持“就地修改”或副作用操作，但其 transform 操作符（|...|）提供了一种函数式、不可变的数据更新机制：它允许你基于原始数据（用 $$ 引用）构造一个新对象，并仅对指定路径下的字段进行增量替换，其余结构保持完全不变。
要将示例 JSON 中 Account.OrderID 的值由 "order104" 替换为 "1234"，可使用如下 JSONata 表达式：
$$ ~> |Account|{ "OrderID": "1234" }|
✅ 表达式解析：
- $$ 表示整个输入 JSON（即根对象）；
- ~> 是 transform 操作符，用于对左侧数据执行结构化更新；
- |Account|{ ... }| 表示：在 Account 对象层级上，合并右侧对象 { "OrderID": "1234" } —— 即仅覆盖 OrderID 字段，其他字段（如 Account Name、Product 等）自动保留。
⚠️ 注意：Jsonata4Java 是 IBM 维护的 Java 绑定库，其功能集可能滞后于最新 JSONata 规范。请确认你使用的版本 ≥ v1.8.0（transform 操作符自该版本起稳定支持）。若调用失败，请升级依赖或改用官方推荐方式：
<!-- Maven 示例 --> <dependency><groupid>com.ibm.jsonata</groupid><artifactid>jsonata4java</artifactid><version>1.8.4</version></dependency>
? 进阶技巧：
- 若需动态路径（如变量控制字段名），可结合 $merge() 或嵌套 ~>：
$$ ~> |Account|{ $merge([{"OrderID": "1234"}, $sift($$."Account")]) }| - 修改数组内元素（如第一个 Product 的 Price）：
$$ ~> |Account.Product[0]|{ "Price": 42.99 }| - 多字段批量更新：
$$ ~> |Account|{ "OrderID": "1234", "Account Name": "Firefly Ltd" }|
总结：JSONata 的 ~> + |path|{...}| 模式是安全、可预测且符合函数式理念的“写入”方案——它不修改原始数据，而是生成结构一致、语义清晰的新 JSON。在 Jsonata4Java 中正确使用该语法，即可实现配置驱动、路径灵活的 JSON 数据更新需求。
