Come funziona JavaScript Object Notation (JSON)

La maggior parte delle richieste e delle risposte da e verso IBM® Cloudant® for IBM Cloud® utilizzare JSON per la formattazione del contenuto e della struttura dei dati e delle risposte.

Nei database IBM Cloudant , l'oggetto JSON viene utilizzato per rappresentare varie strutture, inclusi tutti i documenti in un database.

L'analisi del JSON in un oggetto JavaScript è supportata attraverso la funzione JSON.parse() in JavaScript o attraverso varie librerie che eseguono per te l'analisi del contenuto in un oggetto JavaScript. Le librerie per l'analisi e la generazione di JSON sono disponibili per molti linguaggi di programmazione principali.

JSON viene utilizzato perché è la soluzione più semplice e più semplice per lavorare con i dati che utilizza un browser web. Di conseguenza, le strutture JSON possono essere valutate e utilizzate come oggetti JavaScript all'interno dell'ambiente del browser web. Inoltre JSON si integra con il JavaScript lato server utilizzato in IBM Cloudant. I documenti JSON sono sempre codificati in UTF-8.

Attenzione a seguire queste linee guida:

  • Le tue strutture JSON siano valide.
  • Si normalizzano le stringhe nei documenti JSON richiamati da IBM Cloudant.

JSON supporta gli stessi tipi di base supportati da JavaScript: numeri, stringhe, Booleani, array e oggetti.

Numeri

I numeri possono essere valori interi o valori in virgola mobile.

Esempio di un numero in formato JSON

123

Stringhe

Le stringhe devono essere racchiuse da virgolette doppie. Le stringhe supportano i caratteri Unicode e sfuggono a un backslash.

Esempio di una stringa in formato JSON

"A String"

Valori booleani

Un valore true o false.

Esempio di valore booleano in formato JSON

{
  "value": true
}

Array

Un elenco di valori racchiusi tra parentesi. I valori racchiusi possono essere qualsiasi JSON valido.

Esempio di un array in formato JSON

[
    "one",
    2,
    "three",
    [],
    true,
    {
        "foo":
        "bar"
    }
]

Esempio di un array in formato JSON (lineare):

[ "one", 2, "three", [], true, { "foo": "bar" } ]

Oggetti

Una serie di coppie key-value , come ad esempio una schiera associativa, o un hash. La chiave deve essere una stringa, ma il valore può essere uno qualsiasi dei valori JSON supportati.

Esempio di un oggetto JSON

{
    "servings" : 4,
    "subtitle" : "Easy to make in advance, and then cook when ready",
    "cooktime" : 60,
    "title" : "Chicken Coriander"
}