Chemin JSON - Cloud

Guide d'utilisation de Talend Cloud API Tester

Version
Cloud
Language
Français (France)
Product
Talend Cloud
Module
Talend API Tester
Content
Création et développement > Test d'API
Cette section décrit les expressions du chemin JSON que vous pouvez utiliser avec Talend Cloud API Tester.

Pour plus d'informations, consultez l'article JSONPath - XPath pour JSON (en anglais).

Vous trouverez également un évaluateur en ligne de chemin d'accès JSON ici. L'implémentation sous-jacente peut varier de celle utilisée dans Talend Cloud API Tester, ainsi les résultats peuvent varier.

Voici quelques conseils pour utiliser les payloads JSON :

  • Le dollar $ désigne un objet racine du contenu JSON.
  • Le point . vous permet d'obtenir les attributs d'un objet ou d'aller plus loin dans l'arborescence.
  • Les crochets [] ciblent les tableaux et permet de sélectionner un élément particulier ou une portion de ceux-ci.
  • Les deux points .. vous permettent de réunir de manière récursive tous les attributs selon leur nom.

Comme vous pouvez le voir ci-dessous, l'implémentation actuelle dans Talend Cloud API Tester suit principalement la référence, mais varie sur certains points.

Échantillons d'expressions de chemin d'accès JSON

Cette section liste les expressions et leurs résultats par rapport à l'échantillon de fichier JSON suivant :

{
  "store": {
    "book": [
        {
          "category": "reference",
          "author": "Nigel Rees",
          "title": "Sayings of the Century",
          "price": 8.95
        },
        {
          "category": "fiction",
          "author": "Evelyn Waugh",
          "title": "Sword of Honour",
          "price": 12.99
        },
        {
          "category": "fiction",
          "author": "Herman Melville",
          "title": "Moby Dick",
          "isbn": "0-553-21311-3",
          "price": 8.99
        },
        {
          "category": "fiction",
          "author": "J. R. R. Tolkien",
          "title": "The Lord of the Rings",
          "isbn": "0-395-19395-8",
          "price": 22.99
        }
      ],
      "bicycle": {
        "color": "red",
        "price": 19.95
    }
  }
}

La table suivante présente certains échantillons d'expressions et leurs résultats.

Expression Valeur
$.store.bicycle.color La valeur de l'attribut de la couleur du vélo (par exemple "red")
$.store.book[0] Le premier nœud "book" dans "store"

$.store.book[1:3]

$.store.book[1,2]

Un tableau du deuxième et troisième nœud "book" dans "store"
$.store.book[-1:] Un tableau contenant le dernier nœud "book" dans "store"
$.store.book[:2] Un tableau contenant le premier et le deuxième nœud "book" dans "store"
$.store.book[1:4:2].author Un tableau des auteurs du deuxième et quatrième nœud "book" dans "store" (par exemple ["Evelyn Waugh","J. R. R. Tolkien"])
$.store.book[1].* Un tableau des valeurs de tous les attributs du deuxième livre (par exemple ["fiction","Evelyn Waugh","Sword of Honour",12.99])
$.store..price Un tableau des valeurs de tous les attributs "price" du nœud "store" (par exemple les prix des livres et vélos [8.95,12.99,8.99,22.99,19.95])
$.store.book.author Un tableau des valeurs de tous les attributs "author" du nœud "book" (par exemple ["Nigel Rees","Evelyn Waugh","Herman Melville","J. R. R. Tolkien"])
$.store.book[?(@.isbn)] Un tableau des livres ayant un attribut "isbn" (par exemple les deux derniers livres)
$.store.book[?(@.price<10)] Un tableau des livres dont le prix est inférieur à "10"
$.. Un tableau de tous les nœuds enfants du nœud racine, récursivement
$..category Un tableau de toutes les valeurs des nœuds "category" (par exemple ["reference","fiction","fiction","fiction"])
$..category[(@.length-1)] La valeur du dernier nœud "category"

Lorsque Talend Cloud API Tester est différent de la référence

L'opérateur étoile

Expression Référence Talend Cloud API Tester
$.store.book[*].author Un tableau avec les auteurs de tous les livres du magasin Retourne un tableau vide, utilise $.store.book.author à la place

L'opérateur à deux points

L'expression $..book est interprétée comme un tableau de tous les nœuds book, ainsi elle retourne un tableau contenant un tableau, puisque le nœud book est un tableau :

[
  [
          { "category": "reference", "author": "Nigel Rees", "title": "Sayings of the Century", "price": 8.95 },
          { "category": "fiction", "author": "Evelyn Waugh", "title": "Sword of Honour", "price": 12.99 },
          { "category": "fiction", "author": "Herman Melville", "title": "Moby Dick", "isbn": "0-553-21311-3", "price": 8.99 },
          { "category": "fiction", "author": "J. R. R. Tolkien", "title": "The Lord of the Rings", "isbn": "0-395-19395-8", "price": 22.99 }
  ]
]

Ensuite, les expressions suivantes sont calculées différemment :

Expression Référence Talend Cloud API Tester
$..book[0] Un tableau contenant le premier nœud book Le premier élément du tableau, c'est-à-dire un tableau contenant tous les livres.
$..book[-1:] Un tableau contenant le dernier livre Non supporté tel quel, fonctionne grâce à ($..book[0][-1:])
$..book[(@.length-1)] Un tableau contenant le dernier livre Non supporté tel quel, fonctionne grâce à ($..book[0][(@.length-1)])
$..book[0,1] Un tableau contenant le premier et deuxième libre Non supporté tel quel, fonctionne grâce à ($..book[0][0,1])
$..book[:2] Un tableau contenant le troisième livre Non supporté tel quel, fonctionne grâce à ($..book[0][:2])