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 définis sont renvoyés 'tels quels' et les résultats de chemin indéfinis sont renvoyés dans un tableau. Cependant, il ne sert à rien d'extraire le nom d'un élément correspondant à un chemin défini - il est déjà connu.

Expression de filtre

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

Opérandes pris en charge :

Opérateurs 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 définis et indéfinis. Un chemin défini ne peut renvoyer que null ou une seule correspondance. Un chemin indéfini 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 défini, car les fonctions génèrent toujours une valeur unique.

Un chemin défini renvoie l'objet/tableau/valeur auquel il fait référence, tandis que le chemin indéfini 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"
         ]
       }