按 RFC 7396 把 Merge Patch 合并到原文档,或者根据修改前后的两个 JSON 生成 Merge Patch;也可以按 RFC 6902 逐条执行 JSON Patch 的 add、remove、replace、move、copy、test 操作,查看每一步的结果和出错的那一条。数据只在浏览器本地处理。
| Merge Patch(RFC 7396) | JSON Patch(RFC 6902) | |
|---|---|---|
| 写法 | 一个 JSON,写出要改的字段和新值 | 一个操作数组,每项包含 op、path、value |
| 删除字段 | 把字段设为 null | {"op": "remove", "path": "/a"} |
| 修改数组 | 只能整个替换数组 | 可以插入、删除、替换某一项,/list/- 表示末尾 |
| 设置 null 值 | 不能(null 表示删除) | 可以 |
| 条件检查 | 不支持 | test 操作,值不符时整个补丁失败 |
| Content-Type | application/merge-patch+json | application/json-patch+json |
/user/tags/0 表示 user.tags 的第一项;键名中的 ~ 写成 ~0,/ 写成 ~1。比较两个 JSON 并生成 JSON Patch,请用 JSON 对比。
选择操作:应用 Merge Patch 时左侧填原文档、右侧填补丁;生成 Merge Patch 时左右分别填修改前后的文档;执行 JSON Patch 时右侧填操作数组。下方显示结果、每条操作的执行情况和 HTTP PATCH 请求写法。
RFC 7396 定义的补丁格式,用一个 JSON 描述要修改的字段,值为 null 表示删除该字段。
RFC 6902 定义的补丁格式,用 add、remove、replace 等操作数组描述修改。
两种都可以,用 Content-Type 区分:application/merge-patch+json 或 application/json-patch+json。
使用 JSON Patch 的 add 操作,路径写成 /数组名/-。
JSON Patch 遇到失败的操作时整个补丁不生效,与规范一致;生成的 Merge Patch 无法表达把值设为 null 的修改。
JSON 数据只在浏览器本地处理,不会上传。
JSON Patch 提示路径不存在时,检查路径是否以 / 开头、数组下标是否越界,键名中的 / 需要写成 ~1。
JSON 对比 · JSON 树形查看器 · 代码对比工具 · cURL 命令生成器 · 全部开发工具