Áú»¢¶Ä²©

3 Fonctionnalit¨¦ JSONPath

Aper?u

Cette section fournit des d¨¦tails sur la fonctionnalit¨¦ JSONPath prise en charge dans les ¨¦tapes de pr¨¦traitement de la valeur de l'¨¦l¨¦ment.

JSONPath se compose de segments s¨¦par¨¦s par des points. Un segment peut ¨ºtre soit un mot simple comme un nom de valeur JSON, * ou une construction plus complexe entre crochets [ ]. Le point de s¨¦paration avant le segment entre crochets est facultatif et peut ¨ºtre omis. Par exemple:

Voir aussi : Echapper les caract¨¨res sp¨¦ciaux des valeurs de macro LLD dans JSONPath.

Segments pris en charge

Pour trouver un segment correspondant en ignorant son ascendance (segment d¨¦tach¨¦), il doit ¨ºtre pr¨¦fix¨¦ par '..' , par exemple $..nom ou $..['nom'] renvoient les valeurs de toutes les propri¨¦t¨¦s 'name'.

Les noms d'¨¦l¨¦ments correspondants peuvent ¨ºtre extraits en ajoutant un suffixe ~ au JSONPath. Il renvoie le nom de l'objet correspondant ou un index au format cha?ne de l'¨¦l¨¦ment de tableau correspondant. Le format de sortie suit les m¨ºmes r¨¨gles que les autres requ¨ºtes JSONPath - les r¨¦sultats de chemin »å¨¦´Ú¾±²Ô¾±s sont renvoy¨¦s 'tels quels' et les r¨¦sultats de chemin in»å¨¦´Ú¾±²Ô¾±s sont renvoy¨¦s dans un tableau. Cependant, il ne sert ¨¤ rien d'extraire le nom d'un ¨¦l¨¦ment correspondant ¨¤ un chemin »å¨¦´Ú¾±²Ô¾± - il est d¨¦j¨¤ connu.

Expression de filtre

L'expression de filtre est une expression arithm¨¦tique en notation infix.

°¿±è¨¦°ù²¹²Ô»å±ðs pris en charge :

°¿±è¨¦°ù²¹³Ù±ð³Ü°ùs pris en charge :

Fonctions

Les fonctions peuvent ¨ºtre utilis¨¦es ¨¤ la fin d'un JSONPath. Plusieurs fonctions peuvent ¨ºtre cha?n¨¦es si la fonction pr¨¦c¨¦dente renvoie une valeur accept¨¦e par la fonction suivante.

Fonctions prises en charge :

Les valeurs num¨¦riques entre guillemets sont accept¨¦es par les fonctions d'agr¨¦gation JSONPath. Cela signifie que les valeurs sont converties du type cha?ne en num¨¦rique si l'agr¨¦gation est requise.

Une entr¨¦e incompatible entra?nera la g¨¦n¨¦ration d'une erreur par la fonction.

Valeur de retour

JSONPaths peut ¨ºtre divis¨¦ en chemins »å¨¦´Ú¾±²Ô¾±s et in»å¨¦´Ú¾±²Ô¾±s. Un chemin »å¨¦´Ú¾±²Ô¾± ne peut renvoyer que null ou une seule correspondance. Un chemin in»å¨¦´Ú¾±²Ô¾± peut renvoyer plusieurs correspondances, essentiellement des JSONPaths avec des listes de noms/index multiples, des morceaux de tableau ou des segments d'expression d¨¦tach¨¦s. Cependant, lorsqu'une fonction est utilis¨¦e, le JSONPath devient »å¨¦´Ú¾±²Ô¾±, car les fonctions g¨¦n¨¨rent toujours une valeur unique.

Un chemin »å¨¦´Ú¾±²Ô¾± renvoie l'objet/tableau/valeur auquel il fait r¨¦f¨¦rence, tandis que le chemin in»å¨¦´Ú¾±²Ô¾± renvoie un tableau des objets/tableaux/valeurs correspondants.

Espace blanc

Les espaces (espace, caract¨¨res de tabulation) peuvent ¨ºtre librement utilis¨¦s dans les segments et les expressions de notation entre parenth¨¨ses, par exemple,$[ 'a' ][ 0 ][ ?( $.b == 'c' ) ][ : -1 ].first( ).

Cha?nes de caract¨¨res

Les cha?nes doivent ¨ºtre entour¨¦es de guillemets simples ' ou doubles ". ? l'int¨¦rieur des cha?nes, les guillemets simples ou doubles (selon ceux qui sont utilis¨¦s pour les encadrer) et les barres obliques inverses \ sont ¨¦chapp¨¦s avec le caract¨¨re barre oblique inverse \.

Exemples

Donn¨¦es d'entr¨¦e

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