execute json xpath()

Prev Next

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.

Parameter

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.

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.