zjsonpatch

Java Library to find / apply JSON Patches according to RFC 6902

License

License

Categories

Categories

JSON Data
GroupId

GroupId

io.fabric8
ArtifactId

ArtifactId

zjsonpatch
Last Version

Last Version

0.3.0
Release Date

Release Date

Type

Type

bundle
Description

Description

zjsonpatch
Java Library to find / apply JSON Patches according to RFC 6902
Project URL

Project URL

https://github.com/fabric8io/zjsonpatch/
Source Code Management

Source Code Management

https://github.com/fabric8io/zjsonpatch

Download zjsonpatch

Dependencies

compile (2)

Group / Artifact Type Version
com.fasterxml.jackson.core : jackson-databind jar 2.3.2
com.fasterxml.jackson.core : jackson-core jar 2.3.2

test (2)

Group / Artifact Type Version
commons-io : commons-io jar 2.4
junit : junit jar 4.8.2

Project Modules

There are no modules declared in this project.

This is an implementation of RFC 6902 JSON Patch written in Java.

Description & Use-Cases

  • Java Library to find / apply JSON Patches according to RFC 6902.
  • JSON Patch defines a JSON document structure for representing changes to a JSON document.
  • It can be used to avoid sending a whole document when only a part has changed, thus reducing network bandwidth requirements if data (in json format) is required to send across multiple systems over network or in case of multi DC transfer.
  • When used in combination with the HTTP PATCH method as per RFC 5789 HTTP PATCH, it will do partial updates for HTTP APIs in a standard way.

Compatible with : Java 6 / 7 / 8

Code Coverage

Package Class, % Method, % Line, %
all classes 100% (6/ 6) 93.6% (44/ 47) 96.2% (332/ 345)

Complexity

  • To find JsonPatch : Ω(N+M) ,N and M represents number of keys in first and second json respectively / O(summation of la*lb) where la , lb represents jsonArray of length la / lb of against same key in first and second json ,since LCS is used to find difference between 2 json arrays there of order of quadratic.
  • To Optimize Diffs ( compact move and remove into Move ) : Ω(D) / O(D*D) where D represents number of diffs obtained before compaction into Move operation.
  • To Apply Diff : O(D) where D represents number of diffs

How to use:

Current Version : 0.3.1

Add following to <dependencies/> section of your pom.xml -

<groupId>io.fabric8</groupId>
<artifactId>zjsonpatch</artifactId>
<version>{version}</version>
  • Available on maven central repository

API Usage

Obtaining Json Diff as patch

JsonNode patch = JsonDiff.asJson(JsonNode source, JsonNode target)

Computes and returns a JSON Patch from source to target, Both source and target must be either valid JSON objects or arrays or values. Further, if resultant patch is applied to source, it will yield target.

The algorithm which computes this JsonPatch currently generates following operations as per rfc 6902 -

  • ADD
  • REMOVE
  • REPLACE
  • MOVE
  • COPY
  • TEST

Apply Json Patch

JsonNode target = JsonPatch.apply(JsonNode patch, JsonNode source);

Given a Patch, it apply it to source Json and return a target json which can be ( json object or array or value ). This operation performed on a clone of source json ( thus, source json is untouched and can be used further).

Example

First Json

{"a": 0,"b": [1,2]}

Second json ( the json to obtain )

 {"b": [1,2,0]}

Following patch will be returned:

[{"op":"MOVE","from":"/a","path":"/b/2","value":0}]

here 'op' represents Operation, 'from' represent path from where value should be moved, 'path' represents where value should be moved and value represents value to move.

Tests:

  1. 100+ selective hardcoded different input jsons , with their driver test classes present under /test directory.
  2. Apart from selective input, a deterministic random json generator is present under ( TestDataGenerator.java ), and its driver test class method is JsonDiffTest.testGeneratedJsonDiff().
io.fabric8

fabric8

open source development platform for kubernetes

Versions

Version
0.3.0
0.2.3
0.2.2