3 JSONPath functionaliteit

Overzicht

Deze sectie geeft details weer van de ondersteunde JSONPath-functionaliteit in stappen voorafgaand aan de bewerking van itemwaarden.

JSONPath bestaat uit segmenten die gescheiden zijn door punten. Een segment kan ofwel een eenvoudig woord zijn, zoals een JSON-waardenaam, *, of een complexere constructie die is ingesloten in vierkante haken [ ]. Het scheidingsteken punt voor een segment met haakjes is optioneel en kan worden weggelaten. Bijvoorbeeld:

Zie ook: Ontsnappen aan speciale tekens in LLD-macrowaarden in JSONPath.

Ondersteunde segmenten

Om een overeenkomend segment te vinden en de hiërarchie te negeren (losgemaakt segment), moet het worden voorafgegaan door '..' , bijvoorbeeld $..name of $..['name'] retourneert waarden van alle 'name' eigenschappen.

Overeenkomende elementnamen kunnen worden geëxtraheerd door een ~-achtervoegsel toe te voegen aan de JSONPath. Het retourneert de naam van het overeenkomende object of een index in stringformaat van het overeenkomende array-item. De outputindeling volgt dezelfde regels als andere JSONPath-zoekopdrachten - definitieve padresultaten worden 'as is' geretourneerd en onbepaalde padresultaten worden in een array geretourneerd. Er is echter niet veel nut in het extraheren van de naam van een element dat overeenkomt met een definitief pad - dat is al bekend.

Filteruitdrukking

De filteruitdrukking is een rekenkundige expressie 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

Invoerdata

{
         "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"
         ]
       }