5. Error Handling

5. 错误处理 (Error Handling)

如果 JSON Patch 文档违反了规范性要求, 或者某个操作未成功, 则 JSON Patch 文档的求值 SHOULD 终止, 且整个补丁文档的应用 SHALL NOT 被视为成功.

关于将 JSON Patch 与 HTTP PATCH 方法一起使用时的错误处理考虑事项, 请参见 [RFC5789], Section 2.2, 其中包括用于指示各种条件的建议状态码.

注意, 根据 [RFC5789], HTTP PATCH 方法是原子的. 因此, 以下补丁不会对文档产生任何更改 (因为 "test" 操作会导致错误):

[
  { "op": "replace", "path": "/a/b/c", "value": 42 },
  { "op": "test", "path": "/a/b/c", "value": "C" }
]