JsonCons.Utilities | JsonCons.JsonPath | JsonCons.JmesPath |
---|---|---|
The JsonCons.Net libraries include classes that complement the functionality of the System.Text.Json namespace. The libraries target .Net Standard 2.1.
The JsonCons.Net libraries offer support for:
- JSON Pointer as defined in RFC 6901
- JSON Patch as defined in RFC 6902
- JSON Merge Patch as defined in RFC 7396
- JSONPath as defined in JsonCons JsonPath
- JMESPath as defined in JMESPath Specification
JSONPath allows you to select from a JsonDocument a list of JsonElement instances that belong to it. JMESPath allows you to transform a JsonDocument into another JsonDocument.
For example, consider the JSON data
string jsonString = @"
{
""Data"":[
{
""KeyOfInterest"":true,
""AnotherKey"":true
},
{
""KeyOfInterest"":false,
""AnotherKey"":true
},
{
""KeyOfInterest"":true,
""AnotherKey"":true
}
]
}
";
using JsonDocument doc = JsonDocument.Parse(jsonString);
JSONPath allows you to select the KeyOfInterest
values like this:
string path = "$.Data[*].KeyOfInterest";
IList<JsonElement> results = JsonSelector.Select(doc.RootElement, path);
and the union of KeyOfInterest
and AnotherKey
values like this:
string path = "$.Data[*]['KeyOfInterest', 'AnotherKey']";
IList<JsonElement> results = JsonSelector.Select(doc.RootElement, path);
The first query produces
[true,false,true]
and the second
[true,true,false,true,true,true]
Note that each element in the result - true
, false
, true
- corresponds to an element
at a specific location in the original JSON document. This is a feature of JSONPath.
JMESPath allows you to select the KeyOfInterest
values like this:
string expr = Data[*].KeyOfInterest;
JsonDocument result = JsonTransformer.Transform(doc.RootElement, expr);
and a multiselect hash of KeyOfInterest
and AnotherKey
values like this:
string expr = "Data[*].{\"Key of Interest\" : KeyOfInterest, \"Another Key\": AnotherKey}";
JsonDocument result = JsonTransformer.Transform(doc.RootElement, expr);
The first query produces
[true,false,true]
and the second
[
{
"Key of Interest": true,
"Another Key": true
},
{
"Key of Interest": false,
"Another Key": true
},
{
"Key of Interest": true,
"Another Key": true
}
]
JMESPath, unlike JSONPath, can create new elements that are not in the original document. JMESPath can transform, while JsonPath can only select.
Reference documentation is available here
Code examples may be found at: