Konspekt: JSON ja selle struktuur

Mis on JSON?

JSON (JavaScript Object Notation) on kerge andmevahetusformaat, mida on lihtne genereerida ja analüüsida. JSON kasutab objektide ja massiivide struktuure, et esitada andmeid kaasaskantavalt ja loetavalt. Kuigi süntaks on pärit JavaScriptist, on JSON keelest sõltumatu ja seda toetavad kõik kaasaegsed programmeerimiskeeled. JSON on eriti populaarne REST API-de edastusvorminguna.

Mõte: Mõtle JSON-ist kui inimloetavast tekstist, mis kirjeldab andmeid võtme-väärtuse paaridena (objektid) ja järjestatud loenditena (massivid).

JSON struktuur

{} – looksulgudes hoitakse objekte: komadega eraldatud "võti": väärtus paarid.
Võtmed on alati jutumärkides (erinevalt JavaScripti objektidest, kus see pole alati nõutud).
Võtmete abil saab objektist konkreetseid andmeid kätte: objekt["võti"] või objekt.võti (keelelt sõltuv).
[] – nurksulgudes hoitakse massiive (0…∞ elementi). Elemendid võivad olla stringid, numbrid, objektid, massiivid, booleanid või null.
Stringiväärtused on alati jutumärkides (topeltjutumärgid "..." on standard).

Pesastamine: Objektid ja massiivid võivad sisaldada teisi objekte ja massiive (piiramatu sügavus), mis võimaldab kirjeldada nii lihtsaid tabeleid kui ka keerukaid andmestruktuure.

JSON andmetüübid

Tüüp	Kirjeldus	Näide
string	Sõnaline tekst jutumärkides	`"Tere, maailm"`
number	Täisarv või ujukomaarv	`42`, `3.14`, `-7`
object	Võtme-väärtuse paaride kogum looksulgudes	`{"nimi":"Mari","vanus":20}`
array	Järjestatud loend nurksulgudes	`[1,2,3]` või `[{"id":1},{"id":2}]`
boolean	Loogikaväärtus	`true`, `false`
null	Puuduv väärtus	`null`

Näited JSON struktuurist

Kompaktne objekt

{
  "id": 1,
  "nimi": "Valve",
  "aktiivne": true
}

Ühe objekti sees on teine objekt

{
  "mang": {
    "pealkiri": "Portal 2",
    "arendaja": {
      "nimi": "Valve",
      "riik": "USA"
    }
  }
}

Mitu objekti massiivis

[
  { "id": 1, "nimi": "Aperture" },
  { "id": 2, "nimi": "Black Mesa" }
]

Objekt "Valve", mille väärtuseks on massiiv pesastatud objektidest

{
  "Valve": [
    { "mang": "Half-Life", "aasta": 1998 },
    { "mang": "Portal",     "aasta": 2007 },
    { "mang": "Dota 2",     "aasta": 2013 }
  ]
}

Töötamine JSON-iga (üldpõhimõtted)

Parsimine: tekst → andmestruktuur (nt JSON.parse JavaScriptis, json.loads Pythonis).
Serialiseerimine: andmestruktuur → tekst (nt JSON.stringify, json.dumps).
Võtmete kasutus: pääsed andmetele ligi võtmete ja indeksite kaudu (nt obj["võti"], massiv[0]).
Kodeering: kasuta UTF-8 et vältida täpitähtede probleeme.

JSON vs JavaScript: JSON nõuab topeltjutumärke nii võtmete kui stringide jaoks ({"key":"value"}). JavaScripti objektides võivad võtmed mõnikord olla ilma jutumärkideta.

Levinud vead ja parimad tavad

Levinud vead

Puuduvad jutumärgid võtmetel või stringidel: { key: value } ❌
Üksikud jutumärgid stringidel: { 'key': 'value' } ❌ (JSON-is peab olema "...")
Järgnevad komad: {"a":1,} ❌
Toetuseta tüübid (nt undefined, Date otse): serialiseeri sobivasse vormi (string/number).

Parimad tavad

Kasuta konsekventseid võtmenimesid (nt snake_case või camelCase).
Lisa skeem/valideerimine (nt JSON Schema), kui vahetad andmeid API-dega.
Hoia andmetüübid stabiilsed (väldi sama välja eri tüüpe eri vastustes).
Formateeri (pretty-print) arenduse ajal, kuid edasta võrgus vajadusel kompaktselt.

Kokkuvõte

JSON on lihtne, inimloetav ja keeletu andmevahetusvorming, mis baseerub objektide ({}) ja massiivide ([]) struktuuril. See toetab põhilisi andmetüüpe (string, number, object, array, boolean, null) ja on tänu universaalsele toele saanud de-facto standardiks REST API-des.