Funktionsweise von JavaScript Object Notation (JSON)

Die meisten Anforderungen und Antworten an und aus IBM® Cloudant® for IBM Cloud® Verwenden Sie JSON zum Formatieren des Inhalts und der Struktur der Daten und Antworten.

In IBM Cloudant-Datenbanken wird das JSON-Objekt verwendet, um verschiedene Strukturen darzustellen, darunter alle Dokumente in einer Datenbank.

Das Parsen von JSON in ein JavaScript-Objekt wird über die Funktion JSON.parse() in JavaScript oder über verschiedene Bibliotheken unterstützt, die das Parsen des Inhalts in ein JavaScript-Objekt für Sie ausführen. Bibliotheken zum Parsen und Generieren von JSON-Code sind für viele der gängigsten Programmiersprachen verfügbar.

JSON wird verwendet, weil es die einfachste und schnellste Lösung für die Arbeit mit Daten über einen Webbrowser ist. Dadurch können JSON-Strukturen ausgewertet und als JavaScript-Objekte in der Web-Browserumgebung verwendet werden. JSON lässt sich auch in das in IBM Cloudant verwendete, serverseitige JavaScript integrieren. JSON-Dokumente werden immer in UTF-8 codiert.

Achten Sie unbedingt auf folgende Leitlinien:

  • Ihre JSON-Strukturen sind gültig.
  • Sie normalisieren Zeichenfolgen in JSON-Dokumenten, die von IBM Cloudant abgerufen wurden.

JSON unterstützt dieselben grundlegenden Typen wie JavaScript: Zahlen, Zeichenfolgen, Boolesche Operatoren, Arrays und Objekte.

Zahlen

Zahlen können Ganzzahlen oder Gleitkommawerte sein.

Beispiel für eine Zahl im JSON-Format

123

Zeichenfolgen

Zeichenfolgen müssen in doppelte Anführungszeichen gesetzt werden. Zeichenfolgen unterstützen Unicode-Zeichen und können einen Backslash mit Escapezeichen versehen.

Beispiel für eine Zeichenfolge im JSON-Format

"A String"

Boolesche Operatoren

Der Wert true oder false.

Beispiel für einen booleschen Wert im JSON-Format

{
  "value": true
}

Arrays

Eine Liste von Werten in Klammern. Die eingeschlossenen Werte können beliebige gültige JSON-Elemente sein.

Beispiel für einen Bereich im JSON-Format

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

Beispiel für einen Bereich im JSON-Format (linear)

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

Objekte

Eine Gruppe von Schlüssel/Wert-Paaren (key-value), z. B. ein assoziatives Array oder ein Hashwert. Der Schlüssel muss eine Zeichenfolge sein, aber der Wert kann jeder unterstütze JSON-Wert sein.

Beispiel für ein JSON-Objekt

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