Fonctionnement de JavaScript Object Notation (JSON)
La plupart des demandes et des réponses vers et de IBM® Cloudant® for IBM Cloud® utiliser JSON pour formater le contenu et la structure des données et des réponses.
Dans les bases de données IBM Cloudant, l'objet JSON est utilisé pour représenter une variété de structures, y compris l'ensemble des documents d'une base de données.
L'analyse syntaxique de JSON en un objet JavaScript est prise en charge par le biais de la fonction JSON.parse()
dans JavaScript, ou par le biais de diverses bibliothèques qui analysent le contenu dans un objet JavaScript pour vous. Des bibliothèques destinées à l'analyse et à la génération JSON sont disponibles pour la plupart des grands langages de programmation.
JSON est utilisé car il s'agit de la solution la plus simple et la plus facile pour utiliser des données nécessitant un navigateur Web. Les structures JSON peuvent donc être évaluées et utilisées en tant qu'objets JavaScript dans l'environnement de navigateur Web. En outre, JSON s'intègre au JavaScript côté serveur utilisé dans IBM Cloudant. Les documents JSON sont toujours encodés au format UTF-8.
Assurez-vous de respecter les instructions suivantes :
- Vos structures JSON sont valides.
- Vous normalisez les chaînes des documents JSON extraits depuis IBM Cloudant.
JSON prend en charge les mêmes types de base que JavaScript : nombres, chaînes, valeurs booléennes, tableaux et objets.
Nombres
Les nombres peuvent être des entiers ou des valeurs en virgule flottante.
Exemple de nombre au format JSON
123
Chaînes
Les chaînes doivent être placées entre guillemets. Les chaînes prennent en charge les caractères Unicode et la mise en échappement d'une barre oblique inversée.
Exemple de chaîne au format JSON
"A String"
Valeurs booléennes
Valeur true
ou false
.
Exemple de valeur booléenne au format JSON
{
"value": true
}
Tableaux
Liste de valeurs entre crochets. Ces valeurs peuvent correspondre à n'importe quelle notation JSON valide.
Exemple de matrice au format JSON
[
"one",
2,
"three",
[],
true,
{
"foo":
"bar"
}
]
Exemple de matrice au format JSON (linéaire)
[ "one", 2, "three", [], true, { "foo": "bar" } ]
Objets
Ensemble de paires key-value
, par exemple un tableau associatif ou un hachage. La clé doit être une chaîne, mais la valeur peut correspondre à n'importe quelle valeur JSON compatible.
Exemple d'objet JSON
{
"servings" : 4,
"subtitle" : "Easy to make in advance, and then cook when ready",
"cooktime" : 60,
"title" : "Chicken Coriander"
}