Формати JSON и YAML¶

JSON¶

JSON (енгл. JavaScript Object Notation) је формат за запис података који потиче из језика JavaScript, али је постао толико уобичајен да се данас користи из великог броја различитих програмских језика (укључујући и C#). У наставку нећемо описивати све детаље овог формата, већ ћемо кроз неколико примера покушати да опишемо оне најкоришћеније. Податке у формату JSON најчешће записујемо у облику објеката (структура, тј. речника) и низова. На пример, наредни JSON запис садржи податке о ученику Петру Петровићу.

{ "ime": "Petar", "prezime": "Petrović", "prosek": 4.75 }

У питању је објекат (речник) са три поља: поље ime чија је вредност Petar, поље vrednost чија је вредност Petrovic и поље prosek чија је вредност нумеричка и износи 4,75. Сви објекти се записују у витичастим заградама, док се и називи поља (кључеви) записују под наводницима. Текстуалне вредности поља се такође записују под наводницима, док се бројевне вредности записују уобичајено, без наводника (уз коришћење децималне тачке, а не запете ако су у питању рационални бројеви).

Низови вредности се наводе између угластих заграда. На пример, запис

["Pera", "Ana", "Jovana"]

представља низ од три ниске (имена ученика). Слично, можемо дефинисати и низ бројева (на пример, оцена једног ученика).

[5, 3, 4, 5, 5]

Елементни низова могу бити и други низови или објекти. У наредном примеру је описан низ ученика.

[
    {
       "ime": "Petar",
       "prezime": "Petrovic",
    },
    {
       "ime": "Ana",
       "prezime": "Anić"
    }
]

Приметимо да формат није осетљив на белине (размаке, преласке у нови ред и слично), па се може користити произвољан стил назубљивања ради повећања читљивости.

Иако формат JSON допушта и прављење низова у којима се мешају подаци различитог типа, то нећемо користити.

Детаљније информације о формату JSON можете пронаћи на интернету (на пример, https://www.json.org/, https://en.wikipedia.org/wiki/JSON).

YAML¶

Формат YAML представља алтернативу формату JSON. За разлику од формата JSON који занемарује белине и допушта слободно форматирање улаза, формат YAML користи белине и угнежђавање да би наметнуо структуру. Размотримо пример листе ученика:

- ime: Petar
  prezime: Petrović
  prosek: 4.75
- ime: Ana
  prezime: Anić
  prosek: 5.00

Елементи низа су наведени у облику набрајања, а речник се препознаје навођењем кључева и вредности раздвојених двотачкама. Нагласимо да постоје и други начини за опис низова и речника (на пример, за навођење низова се поново могу користити угласте заграде). Приметимо да је број унетих карактера мањи него када се користи JSON (на пример, ниске нису ограђене наводницима). Са друге стране, формат је осетљивији на грешке (да је, на пример, поље које садржи презиме било увучено један карактер више или мање, запис не би био исправан). Препуштамо вам да више о овом формату потражите на интернету (на пример, https://yaml.org/, https://en.wikipedia.org/wiki/YAML).

Формат YAML се користи ређе од формата JSON из C# програма, тако да не постоји библиотечка подршка за рад са њим. Једноставна серијализација података у YAML и десеријализација из YAML-а се може постићи коришћењем библиотеке YamlDotNet. Њу је пре коришћења потребно инсталирати, а најједноставнији начин да се то уради је коришћење алатке која се назива NuGet и која омогућава да веома једноставно инсталирате разне библиотеке које могу бити корисне приликом програмирања у језику C#. Ова алатка је интегрисана у Visual Studio. Упутство како се NuGet користи из окружења Visual Studio je доступно овде:

https://docs.microsoft.com/en-us/nuget/consume-packages/install-use-packages-visual-studio

https://docs.microsoft.com/en-us/nuget/quickstart/install-and-use-a-package-in-visual-studio

Инсталирање пакета YamlDotNet може бити још једноставније. Довољно је отворити конзолни прозор (опцијом менија Tools -> NuGet Package Manager -> Package Manager Console) и затим унети наредбу

PM> Install-Package YamlDotNet

Када је библиотека YamlDotNet инсталирана, можемо је употребити. На пример, наредни програм врши серијализацију низа ученика и на екран (у конзолни прозор) исписује податке о датим ученицима у формату YAML. Приметимо да је на почетку програма било потребно укључивање потребног именског простора YamlDotNet.Serialization.

Након покретања програма у конзолу се исписује следећи садржај:

- ime: Pera
  prezime: Peric
- ime: Ana
  prezime: Anic

За вежбу вам остављамо да проучите како се може вршити десеријализација тј. учитавање података из датотеке у формату YAML.

Креирај JSON датотеку која садржи податке о неколико књига из твоје кућне библиотеке. Дефиниши класе за представљање књига и напиши C# програм који учитава податке о књимага из JSON датотеке и приказује их у графичкој апликацији. Омогући измену података о књигама, додавање нових књига и брисање књига у графичкој апликацији. Омогући чување измењених података у JSON датотеци. Прилагоди апликацију тако да поред JSON формата подржава и YAML.