3 JSONPath functionaliteit

Overzicht

Deze sectie geeft details over de ondersteunde JSONPath-functionaliteit in de stappen voor voorbewerking van itemwaarden.

JSONPath bestaat uit segmenten die worden gescheiden door punten. Een segment kan een eenvoudig woord zijn zoals een JSON-waardenaam, * of een complexere constructie die wordt ingesloten in vierkante haken [ ]. Het scheidende punt vóór het hokje-segment is optioneel en kan worden weggelaten. Bijvoorbeeld:

Zie ook: Speciale tekens ontsnappen uit LLD-macrowaarden in JSONPath.

Ondersteunde segmenten

Om een overeenkomend segment te vinden zonder rekening te houden met de hiërarchie ervan (losgekoppeld segment), moet het worden voorafgegaan door '..' , bijvoorbeeld $..name of $..['name'] geeft waarden terug van alle 'name'-eigenschappen.

Overeenkomende elementnamen kunnen worden geëxtraheerd door een ~ achtervoegsel toe te voegen aan de JSONPath. Hiermee wordt de naam van het overeenkomende object of een index in stringformaat van het overeenkomende array-item geretourneerd. De uitvoerindeling volgt dezelfde regels als andere JSONPath-query's - definitieve padresultaten worden 'zoals ze zijn' geretourneerd en onbepaalde padresultaten worden als array geretourneerd. Er is echter weinig nut om de naam van een element dat overeenkomt met een definitief pad, te extraheren - deze is immers al bekend.

Filterexpressie

De filterexpressie is een arithmetische uitdrukking in infixnotatie.

Ondersteunde operanden:

Ondersteunde operatoren:

Functies

Functies kunnen aan het einde van JSONPath worden gebruikt. Meerdere functies kunnen worden gekoppeld als de voorgaande functie een waarde retourneert die wordt geaccepteerd door de volgende functie.

Ondersteunde functies:

Tussen aanhalingstekens geplaatste numerieke waarden worden geaccepteerd door de JSONPath-aggregatiefuncties. Dit betekent dat de waarden van het tekenreeptype naar numeriek worden geconverteerd als aggregatie vereist is.

Incompatibele invoer zal de functie een fout laten genereren.

Uitvoerwaarde

JSON-paden kunnen worden verdeeld in definitieve en onbepaalde paden. Een definitief pad kan alleen null of een enkele overeenkomst retourneren. Een onbepaald pad kan meerdere overeenkomsten retourneren, in wezen JSON-paden met losgekoppelde, meerdere namen/indexlijst, array-slice of expressie-segmenten. Echter, wanneer een functie wordt gebruikt, wordt het JSON-pad definitief, omdat functies altijd een enkele waarde uitvoeren.

Een definitief pad retourneert het object/array/waarde waarnaar wordt verwezen, terwijl een onbepaald pad een array retourneert van de overeenkomende objecten/arrays/waarden.

Witruimte

Witruimte (spaties, tabtekens) kan vrij worden gebruikt in segmenten van de vierkante haakjes-notatie en expressies, bijvoorbeeld, $[ 'a' ][ 0 ][ ?( $.b == 'c' ) ][ : -1 ].first( ).

Tekst

Teksten moeten worden omsloten met enkele ' of dubbele " aanhalingstekens. Binnen de teksten worden enkele of dubbele aanhalingstekens (afhankelijk van welke worden gebruikt om het te omsluiten) en schuine strepen \ geëscaped met het schuine streep \ teken.

Voorbeelden

Invoergegevens

{
         "books": [
           {
             "category": "reference",
             "author": "Nigel Rees",
             "title": "Sayings of the Century",
             "price": 8.95,
             "id": 1
           },
           {
             "category": "fiction",
             "author": "Evelyn Waugh",
             "title": "Sword of Honour",
             "price": 12.99,
             "id": 2
           },
           {
             "category": "fiction",
             "author": "Herman Melville",
             "title": "Moby Dick",
             "isbn": "0-553-21311-3",
             "price": 8.99,
             "id": 3
           },
           {
             "category": "fiction",
             "author": "J. R. R. Tolkien",
             "title": "The Lord of the Rings",
             "isbn": "0-395-19395-8",
             "price": 22.99,
             "id": 4
           }
         ],
         "services": {
           "delivery": {
             "servicegroup": 1000,
             "description": "Next day delivery in local town",
             "active": true,
             "price": 5
           },
           "bookbinding": {
             "servicegroup": 1001,
             "description": "Printing and assembling book in A5 format",
             "active": true,
             "price": 154.99
           },
           "restoration": {
             "servicegroup": 1002,
             "description": "Various restoration methods",
             "active": false,
             "methods": [
               {
                 "description": "Chemical cleaning",
                 "price": 46
               },
               {
                 "description": "Pressing pages damaged by moisture",
                 "price": 24.5
               },
               {
                 "description": "Rebinding torn book",
                 "price": 99.49
               }
             ]
           }
         },
         "filters": {
           "price": 10,
           "category": "fiction",
           "no filters": "no \"filters\""
         },
         "closed message": "Store is closed",
         "tags": [
           "a",
           "b",
           "c",
           "d",
           "e"
         ]
       }