...
Mechanism for Delta generation
Additional Details
Format/Conventions to be used for Delta Report (not finalized)
There are several ways of representing the differences between JSON but here we discuss the JSON Patch format of representing these differences because the proposed Delta report closely represents JSON patch with a few differences. This approach focuses in producing another JSON document that represents the differences between the two JSON's that have been compared.
...
The operation "op" field in a JSON patch document can have following values:
| Operation | Description | Delta report equivalent |
|---|---|---|
add | Adds the value at the target location; if the value exists in the given location, it’s replaced | if the value is not present in the source json, but was found in the comparand json, then it should be considered an "add" action |
remove | Removes the value at the target location | if a value was present at the source json, but was not found in the comparand json, then it should be considered as "delete" action |
replace | Replaces the value at the target location | if a value is present in the source json, but an updated value is present in the comparand json, then it will be considered as "update" action |
move | Removes the value at a specified location and adds it to the target location | N/A |
copy | Copies the value at a specified location to the target location | N/A |
test | Tests that a value at the target location is equal to a specified value | N/A |
| Code Block | ||||
|---|---|---|---|---|
| ||||
[
{ "op": "test", "path": "/a/b/c", "value": "foo" },
{ "op": "remove", "path": "/a/b/c" },
{ "op": "add", "path": "/a/b/c", "value": [ "foo", "bar" ] },
{ "op": "replace", "path": "/a/b/c", "value": 42 },
{ "op": "move", "from": "/a/b/c", "path": "/a/b/d" },
{ "op": "copy", "from": "/a/b/d", "path": "/a/b/e" }
] |
...