Prise en charge de JSON dans Qt

Qt prend en charge le traitement des données JSON. JSON est un format d’encodage de données orientées objet issu de JavaScript, mais désormais largement utilisé comme format d’échange de données sur Internet.

La prise en charge de JSON dans Qt fournit une API C++ facile à utiliser pour analyser, modifier et enregistrer des données JSON.

Pour plus de détails sur le format de données JSON, consultez le site json.org et la RFC 8259.

Présentation

JSON est un format permettant de stocker des données structurées. Il comporte 6 types de données de base :

• bool
• double
• chaîne
• array
• object
• null

Une valeur peut être de n'importe lequel des types ci-dessus. Une valeur booléenne est représentée par les chaînes « true » ou « false » en JSON. JSON ne spécifie pas explicitement la plage valide pour les nombres, mais la prise en charge dans Qt est limitée à la plage de validité et à la précision des nombres de type double. Une chaîne peut être n'importe quelle chaîne Unicode valide. Un tableau est une liste de valeurs, et un objet est un ensemble de paires clé/valeur. Toutes les clés d'un objet sont des chaînes, et un objet ne peut contenir aucune clé en double.

Dans la représentation textuelle de JSON, les tableaux sont placés entre crochets ([ ... ]) et les objets entre accolades ({ ... }). Les éléments des tableaux et des objets sont séparés par des virgules. Le séparateur entre les clés et les valeurs d’un objet est un deux-points (:).

Un document JSON simple codant une personne, son âge, son adresse et ses numéros de téléphone pourrait ressembler à ceci :

{
    "FirstName": "John",
    "LastName": "Doe",
    "Age": 43,
    "Address": {
        "Street": "Downing Street 10",
        "City": "London",
        "Country": "Great Britain"
    },
    "Phone numbers": [
        "+44 1234567",
        "+44 2345678"
    ]
}

L'exemple ci-dessus est constitué d'un objet comportant 5 paires clé/valeur. Deux des valeurs sont des chaînes de caractères, une est un nombre, une autre est un objet et la dernière est un tableau.

Un document JSON valide est soit un tableau, soit un objet ; un document commence donc toujours par un crochet ou une accolade.

Les classes JSON

Toutes les classes JSON sont des classes basées sur les valeurs et partagées implicitement.

La prise en charge de JSON dans Qt comprend les classes suivantes :