Was ist JSON

Die zwei Container: Objekte und Arrays

Alles in JSON baut auf zwei Strukturen auf. Ein Objekt ist eine ungeordnete Menge von Schlüssel/Wert-Paaren in geschweiften Klammern – die Schlüssel sind immer Strings, die Werte können jeder JSON-Wert sein, und Paare werden durch Kommata getrennt. Ein Array ist eine geordnete Liste von Werten in eckigen Klammern; seine Werte dürfen beliebig gemischte Typen haben.

{
  "name": "Ada Lovelace",
  "born": 1815,
  "mathematician": true
}

[
  "analytical engine",
  1843,
  null
]

Die sechs Datentypen

Vier sind Skalare – string, number, boolean und null –, und zwei sind die oben genannten Container. Die Regeln, die Neulinge überraschen, sind wenige, aber streng: Strings stehen immer in doppelten Anführungszeichen (einfache sind ungültig), Zahlen brauchen keine Anführungszeichen und dürfen nicht hexadezimal geschrieben sein, Booleans sind exakt die kleingeschriebenen Token true und false, und null ist ein eigener Wert, der bewusst leer bedeutet.

Escaping: was in einem String leben darf

Innerhalb eines Strings müssen zwei Zeichen escaped werden, wo immer sie auftauchen: das doppelte Anführungszeichen (als \") und der Backslash (als \\). Für Steuerzeichen gibt es sechs weitere Escapes – \n für Zeilenumbruch, \t für Tabulator, \r für Wagenrücklauf, \b für Backspace, \f für Seitenvorschub –, und \/ für den Schrägstrich ist legal, aber optional. Jedes andere Zeichen darf wörtlich als UTF-8 erscheinen oder als \uXXXX-Escape für seinen Unicode-Codepoint – beide Formen bedeuten für einen Parser exakt denselben String.

"path": "C:\\Users\\ada"
"quote": "she said \"hi\""
"emoji": "\ud83d\ude00"

path:   C:\Users\ada
quote:  she said "hi"
emoji:  😀

Leerraum, Formatierung und warum Pretty-Printing existiert

Zwischen den strukturellen Satzzeichen erlaubt JSON genau vier Leerraumzeichen: Leerzeichen, Tabulator, Zeilenumbruch und Wagenrücklauf. Diese Erlaubnis macht Formatierung erst möglich – dasselbe Dokument kann auf der Leitung eine unlesbare Zeile sein und in Ihrem Editor ein eingerückter Baum, und beide sind für einen Parser Byte für Byte dieselben Daten. Formatierung ändert nichts an der Bedeutung; deshalb kann das Formatter-Tool gefahrlos auf jedem Payload laufen und ist minifiziertes JSON die übliche Wahl für den Transport.

• Keine Kommentare: RFC 8259 hat Kommentare bewusst entfernt, nachdem echte Parser auseinanderliefen. JSONC ist die inoffizielle Erweiterung, die manche Tools akzeptieren.
• Keine Kommata am Ende: [1, 2, 3,] ist ungültig, so freundlich es auch aussieht.
• Doppelte Schlüssel: Parser behalten entweder den ersten oder den letzten – RFC 8259 überlässt es den Implementierungen, weshalb Duplikate ein Bug sind, selbst wo sie parsen.
• Beliebige oberste Ebene: Jeder Wert darf ein ganzes Dokument sein – ein Array aus Zahlen ist vollständiges JSON.

Wo JSON benutzt wird – und wo nicht

JSON besitzt drei Gebiete: API-Anfrage- und Antwortkörper, strukturierte Konfiguration, in der Kommentare nicht fehlen, und ruhende Daten in Dokumentendatenbanken. Auf der Leitung teilt es sich widerwillig mit zwei Nachbarn – Binärformaten wie protobuf, die bei Größe und Geschwindigkeit gewinnen, wenn beide Enden ein Schema teilen, und YAML, das bei handeditierbarer Ops-Konfiguration gewinnt. JSON tief zu verstehen ist daher keine Fähigkeit unter vielen; es ist die Voraussetzung, um beide Nachbarn zu lesen, denn YAML 1.2 parst JSON, und die meisten Binärschemata dokumentieren sich mit JSON-Beispielen.