Co to je JSON a jak se s ním pracuje?
JSON (JavaScript Object Notation) je textový formát pro ukládání a výměnu dat [4]. Umožňuje poskytnout standardizovaný způsob, jakým si mohou různé systémy vyměňovat informace ve formě, která je snadno čitelná pro lidi i stroje [4]. Hlavní myšlenkou JSONu je jednoduchá a efektivní reprezentace strukturovaných dat, díky čemuž je tento formát zcela nezávislý na konkrétním programovacím jazyce [4].
V jazyce C# a na platformě .NET [3] se s JSON daty pracuje pomocí systémové třídy HttpClient a metod z oboru názvů System.Net.Http.Json. Zápis await Http.GetFromJsonAsync<TypObjektu>("cesta/k/souboru.json") říká kompilátoru: "Pošli HTTP požadavek na danou adresu, stáhni textový JSON a rovnou ho přelož do předpřipravené C# struktury." [3].
Technické pojmy a nástroje
JSON Objekt – základní datová struktura v JSON souboru, která reprezentuje jednu konkrétní entitu [4]. Slouží k uložení sady vlastností pomocí formátu párů klíč-hodnota. Zapisujeme do složených závorek způsobem { "klic": "hodnota", "cislo": 123 } [4].
JSON Pole (Array) – uspořádaný seznam hodnot nebo objektů [4]. Slouží k uložení kolekce více prvků, například celého seznamu načítaných položek. Zapisujeme do hranatých závorek způsobem [ { ... }, { ... } ] [4].
C# Model (Třída) – datová struktura v jazyce C#, do které se textový JSON v paměti aplikace překládá [1]. Slouží jako "překladová šablona", která zachytí strukturu objektu, aby s ním bylo možné v objektově orientovaném kódu pracovat [1]. Zapisujeme jako třídu, např. public class Model { public string Vlastnost { get; set; } }.
HttpClient – systémová třída na platformě .NET, bez které by aplikace nemohla komunikovat s okolím [3]. Slouží k odesílání HTTP požadavků a přijímání dat z webových serverů [3]. V Blazor komponentě se obvykle připojuje zápisem @inject HttpClient Http.
GetFromJsonAsync – asynchronní metoda, která rozšiřuje možnosti platformy .NET pro práci se sítí [3]. Slouží k odeslání požadavku a automatickému převodu přijatého textového JSONu přímo do podoby C# objektu [3]. Zapisujeme způsobem var data = await Http.GetFromJsonAsync<TypObjektu[]>("data.json");.
