Áú»¢¶Ä²©

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