01 / Postup
Ako to funguje
Načíta zdokumentovanú podmnožinu vstupu a zapíše zodpovedajúcu výstupnú reprezentáciu.
Užitočná poznámka
Pri zložitej syntaxi alebo produkčných súboroch overte výsledok v cieľovej aplikácii aj špecializovaným nástrojom.
Formátovanie kódu / MULTIVERTO
Zapíšte hodnoty JSON v čitateľnej podmnožine YAML.
Každý textový nástroj použite na predchádzajúci výsledok.
01 / Postup
Načíta zdokumentovanú podmnožinu vstupu a zapíše zodpovedajúcu výstupnú reprezentáciu.
Pri zložitej syntaxi alebo produkčných súboroch overte výsledok v cieľovej aplikácii aj špecializovaným nástrojom.
02 / Príklad
{"osoba":{"meno":"Ada","sprava":"Ahoj","aktivny":true}}"osoba":
"meno": "Ada"
"sprava": "Ahoj"
"aktivny": true03 / Postup
Zapíšte hodnoty JSON v čitateľnej podmnožine YAML. Načíta zdokumentovanú podmnožinu vstupu a zapíše zodpovedajúcu výstupnú reprezentáciu. JSON na YAML zapisuje kľúče a reťazce v úvodzovkách s odsadením po dvoch medzerách. Text ako true či 001 tak náhodou nezmení typ. Výstup zámerne nepoužíva kotvy, značky ani blokové reťazce.
JSON a YAML opisujú vnorené mapy, zoznamy a skalárne hodnoty, ale YAML navyše ponúka kotvy, značky, blokové reťazce a pravidlá implicitných typov. Smer JSON na YAML zapisuje malú explicitnú podmnožinu: kľúče a reťazce v úvodzovkách, odsadenie po dvoch medzerách a čísla, boolean aj null kompatibilné s JSON. Opačný smer číta túto podmnožinu, jednoduché necitované skaláre a priamy zápis JSON; netvrdí, že parsuje každý platný dokument YAML. Úvodzovky bránia náhodnej zmene textu true na boolean. Duplicitné kľúče a chybné odsadenie sa odmietajú. Na pokročilé konfigurácie použite úplný YAML parser.
Zmena dátového formátu je mapovanie medzi dvoma modelmi informácií, nie iba výmena interpunkcie. Začnite malým reprezentatívnym záznamom, ktorý podľa potreby obsahuje znak mimo ASCII, chýbajúce pole alebo vnorenú hodnotu. Spustite prevod a sledujte, ako sa zapisujú kľúče, poradie, čísla, null, polia a opakované položky. Cieľový formát nemusí mať priamu obdobu niektorej vlastnosti zdroja; konkrétny návod popisuje podporované mapovanie. Výstup otvorte v cieľovej aplikácii a podľa možnosti ho preveďte späť na porovnanie podstatných polí. Pri hromadnej migrácii alebo externom kontrakte použite úplný parser a testy schémy.
Pôvodný zdroj si nechajte vedľa výsledku a pred veľkým dokumentom vyskúšajte krátky známy príklad. Porovnávajte významový obsah, nielen veľkosť súboru či počet riadkov. Po transformácii skontrolujte názvy, reťazce v úvodzovkách, znaky mimo ASCII, konce riadkov aj opakované polia. Čitateľný výsledok neoveruje schému, nedokazuje spustiteľnosť kódu ani bezpečnosť zverejnenia dát. Táto stránka spracúva text v prehliadači a ukazuje výsledok ako text, ale po vložení do inej aplikácie sa uplatnia jej pravidlá. Ak nástroj vstup odmietne, nájdite nepodporovanú konštrukciu a podľa potreby použite špecializovaný parser. Pri kopírovaní z dokumentácie si všimnite typografické úvodzovky, neviditeľné medzery a znak poradia bajtov na začiatku textu. Tieto znaky môžu vyzerať nenápadne, no parser ich môže vyhodnotiť inak než obyčajnú medzeru alebo úvodzovku.