JSON Patch java库之zjsonpatch

介绍

zjsonpatch是用Java编写的RFC 6902 JSON Patch的实现。github地址：GitHub - flipkart-incubator/zjsonpatch: This is an implementation of RFC 6902 JSON Patch written in Java

1、描述：

• 实现了RFC 6902 JSON Patch标准的java库；
• 避免仅更改一部分json文档时发送整个json文档的情况，从而降低了网络带宽需求；
• 当与RFC 5789 HTTP PATCH的HTTP PATCH方法结合使用时，它将以标准方式对HTTP API进行部分更新。

2、功能：

• 获取两个json文档的diff信息，并以这个diff信息作为patch（使用json来描述，包含了op、patch、value）；
• 可以将一个patch，作用在一个json文档上；

根据上篇blog（jsonpatch介绍_赶路人儿的博客-CSDN博客_jsonpatch）可知，RFC 6902 JSON Patch标准定义了以下五种operations：add、remove、replace、move、copy

示例

maven pom.xml：

<groupId>com.flipkart.zjsonpatch</groupId>
<artifactId>zjsonpatch</artifactId>
<version>{version}</version>

这里使用了最新版本0.4.11，可以通过https://search.maven.org/search?q=g:com.flipkart.zjsonpatch 查找对应的版本，也可以在github 上的release上找对应的版本Releases · flipkart-incubator/zjsonpatch · GitHub

1、获取json diff信息作为patch：

public class PatchTest {
    private static final ObjectMapper mapper = new ObjectMapper();
    private static String json1 = "{\"a\":0,\"b\":[1,2]}";
    private static String json2 = "{\"b\": [1,2,0]} ";

    public static void main(String... str) {

        //JsonNode patch = JsonDiff.asJson(JsonNode source, JsonNode target)
        JsonNode patch = JsonDiff.asJson(mapper.readTree(json1),mapper.readTree(json2));

        System.out.println(patch.toPrettyString());
    }

输出：[{"op":"move","from":"/a","path":"/b/2"}]

2、关闭move、copy operations：

上面的输出可以看到，默认情况下计算两个json文档的diff（patch）信息时会使用move、copy这样的operations，虽然这两个operations很有用，但实际业务中有时不需要这样，只想表达成最简单的add、remove、replace这种operations。

private static EnumSet<DiffFlags> flags = DiffFlags.dontNormalizeOpIntoMoveAndCopy().clone();

JsonNode patch = JsonDiff.asJson(mapper.readTree(json1),mapper.readTree(json2),flags );

输出：[{"op":"remove","path":"/a","value":0},{"op":"add","path":"/b/2","value":0}]

3、应用patch：

通过diff计算出来的patch，可以应用到一个json文档上，并返回patch后的json文档。这个过程是对原json文档的一个克隆，所以不会修改原sjon文档的内容。

public class PatchTest {
    private static final ObjectMapper mapper = new ObjectMapper();
    private static EnumSet<DiffFlags> flags = DiffFlags.dontNormalizeOpIntoMoveAndCopy().clone();

    private static String json1 = "{\"a\":0,\"b\":[1,2]}";
    private static String json2 = "{\"b\": [1,2,0]} ";

    public static void main(String... str) {

        //JsonNode patch = JsonDiff.asJson(JsonNode source, JsonNode target)
        JsonNode patch = JsonDiff.asJson(mapper.readTree(json1),mapper.readTree(json2));
        //System.out.println(patch.toPrettyString());

        //JsonNode target = JsonPatch.apply(JsonNode patch, JsonNode source);
        JsonNode target = JsonPatch.apply(patch, mapper.readTree(json1));
        System.out.println(target .toPrettyString());
    }

输出：{"b":[1,2,0]}