execute json xpath(key a, expression b, array as text c, ignore exception d, decode e)

Gruppe

Basic Functions


Führt eine JSONPath-Abfrage b gegen ein im internen Cache vorhandenes JSON-Objekt (unter Schlüssel a) aus.

Zum Rückgabewert der Funktion siehe Parameter c.

Parameterbeschreibung


Parameter

Beschreibung

a

Schlüsselname des JSON-Objekts im Cache. Siehe Funktion parse json and add to cache(data a, key b).

b

Die JSONPath-Abfrage. Siehe https://github.com/json-path/JsonPath.

c

(optional) Bei true wird das Ergebnis der Abfrage als JSON-String zurück gegeben. Bei false wird die Anzahl der Elemente im Ergebnis-JSON-Array bzw. die Anzahl der Key-Value-Paare im Ergebnis-JSON-Objekt zurück gegeben. Default: false.

Alternativ kann man in diesem Parameter den Namen einer Map angeben, wenn das Ergebnis der Abfrage ein Objekt ist. In diese Map werden dann die Key-Value-Paare des Objekts geschrieben. Der Rückgabewert der Funktion ist dann die Anzahl dieser Key-Value-Paare.

Siehe Beispiele unten zur Veranschaulichung.

d

Falls true, dann wird eine aufgetretene Exception ignoriert und ein leerer String zurückgegeben. Default: <leer> (== false).

e

(optional) Liefert die JSONPath-Abfrage ein Array in welchem Sonderzeichen enthalten sind, wie z. B. das /-Zeichen, dann werden diese per Default escaped mit dem \-Zeichen. Mit true können Sie dieses Verhalten unterbinden. Default: false.

Beispiele


Datei:


{
"store": {
"book": [
{
"category": "reference",
"author": "Nigel Rees",
"title": "Sayings of the Century",
"price": 8.95
},
{
"category": "fiction",
"author": "Evelyn Waugh",
"title": "Sword of Honour",
"price": 12.99
},
{
"category": "fiction",
"author": "Herman Melville",
"title": "Moby Dick",
"isbn": "0-553-21311-3",
"price": 8.99
},
{
"category": "fiction",
"author": "J. R. R. Tolkien",
"title": "The Lord of the Rings",
"isbn": "0-395-19395-8",
"price": 22.99
}
],
"bicycle": {
"color": "red",
"price": 19.95
}
},
"expensive": 10
}


Parameter b: $.store.book[*].author

Parameter c: true

Ergebnis: ["Nigel Rees","Evelyn Waugh","Herman Melville","J. R. R. Tolkien"]

Hinweis: Das Ergebnis der Abfrage ist hier ein Array mit 4 Elementen.


Parameter b: $.store.book[*].author

Parameter c: false

Ergebnis: 4


Parameter b: $.store.book[0].['author','title']

Parameter c: true

Ergebnis: {author=Nigel Rees, title=Sayings of the Century}

Hinweis: Das Ergebnis der Abfrage ist hier ein Objekt mit 2 Key-Value-Paaren.


Parameter b: $.store.book[0].['author','title']

Parameter c: false

Ergebnis: 2


Parameter b: $.store.book[0].['author','title']

Parameter c: mymap

Ergebnis: 2

Hinweis: Die Map mymap enthält nun die beiden Key-Value-Paare author=Nigel Rees und title=Sayings of the Century.