4 Funcionalitat JSONPath

Vista general

Aquesta secció proporciona detalls sobre la funcionalitat JSONPath admesa a les passes de preprocessament del valor de l'element.

JSONPath consta de segments separats per punts. Un segment pot ésser una paraula simple com un nom de valor JSON, (*) o una construcció més complexa entre claudàtors. El període de separació abans del segment entre parèntesis és opcional i es pot ometre. Per exemple:

Veieu també: Escapar de caràcters especials dels valors de macro LLD a JSONPath.

Segments admesos

Per trobar un segment coincident ignorant la seva ascendència (segment separat), ha d'anar prefixat amb dos punts ('..'). Per exemple, $..name o $..['name'] retornen els valors de totes les propietats name.

Els noms dels elements coincidents es poden extreure afegint un sufix barrat ~ al JSONPath. Retorna el nom de l'objecte corresponent o un índex de cadena de l'element de matriu corresponent. El format de sortida segueix les mateixes regles que altres consultes JSONPath: els resultats del camí definit es retornen 'tal qual' i els resultats del camí no definit es retornen en una matriu. Tot i així, no té sentit extreure el nom d'un element corresponent a un camí definit: ja se sap.

Expressió de filtre

L'expressió de filtre és una expressió aritmètica en notació infix.

Operands admesos:

Operadors compatibles:

Funcions

Les funcions es poden emprar al final d'un JSONPath. Es poden encadenar diverses funcions si la funció anterior retorna un valor acceptat per la funció següent.

Funcions admeses:

Els valors numèrics entre cometes són admesos per les funcions agregades JSONPath. Això vol dir que els valors es converteixen del tipus de cadena a numèric si cal l'agregació. Una entrada incompatible farà que la funció generi un error.

Valor de retorn

Els camins JSON es poden dividir en camins definits i no definits. Un camí definit només pot retornar una coincidència nul·la o única. Un camí no definit pot retornar diverses coincidències: JSONPaths amb diverses llistes de nom/índex, fragments de matriu o segments d'expressió separats. Tanmateix, quan s'empra una funció, el JSONPath s'estableix, ja que les funcions sempre generen un valor únic.

Un camí definit retorna l'objecte/matriu/valor al qual fa referència. En canvi, el camí no definit retorna una matriu dels objectes/matrius/valors corresponents.

Regles de format del camí

Els espais en blanc (espai, caràcter de tabulació) es poden emprar en segments i expressions de notació de claudàtors, per exemple: $[ 'a' ][ 0 ][ ?( $.b == 'c' ) ][ : -1 ].first ( ).

Les cadenes s'han de tancar amb cometes simples (') o dobles ("). Dins de les cadenes, les cometes simples o dobles (segons quines s'utilitzin per tancar-la) i les barres invertides (\) s'escapen amb el caràcter de barra invertida (\).

Exemple

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