JSON 合并补丁
创建或应用 RFC 7396 定义的 JSON 合并补丁。在创建模式下,比较原始文档和目标文档,生成两者之间最精简的合并补丁。在应用模式下,将补丁合并到文档中;其中 null 会删除键,对象则会递归合并。
常见问题
什么是 JSON 合并补丁?
合并补丁由 RFC 7396 定义,是一种以 JSON 文档形式呈现所描述更改的补丁。键可以设置或替换为指定值;设为 null 的键会被删除,嵌套对象则会合并。API 可通过媒体类型 application/merge-patch+json 接受此补丁。
它与 JSON 补丁有什么区别?
JSON 补丁(RFC 6902)是包含路径的操作列表。合并补丁更易读写,但无法将值设为 null,而且始终替换整个数组,不能改单个数组项。
为什么创建模式会拒绝我的目标?
在合并补丁中,null 表示删除键,因此无法表达将对象中的某个键设为 null 的目标。提示会指出相应路径。此类更改请使用 JSON 补丁。
如何处理数组?
数组不会逐项合并。如果数组发生变化,补丁会包含整个新数组,应用后会完整替换旧数组。
如果补丁不是对象会怎样?
按照 RFC 7396,非对象补丁(例如数组或字符串)会替换整个文档。
空补丁是什么意思?
在创建模式下,{} 表示两个文档相同。将 {} 应用于 JSON 对象后,对象保持不变。