01 / Postup
Jak to funguje
Načte zdokumentovanou podmnožinu vstupu a zapíše odpovídající výstupní reprezentaci.
Užitečná poznámka
U složité syntaxe nebo produkčních souborů ověřte výsledek v cílové aplikaci i specializovaným nástrojem.
Formátování kódu / MULTIVERTO
Převeďte podporované mapy a seznamy YAML na JSON.
Každý textový nástroj použijte na předchozí výsledek.
01 / Postup
Načte zdokumentovanou podmnožinu vstupu a zapíše odpovídající výstupní reprezentaci.
U složité syntaxe nebo produkčních souborů ověřte výsledek v cílové aplikaci i specializovaným nástrojem.
02 / Příklad
"osoba":
"jmeno": "Ada"
"zprava": "Ahoj"{
"osoba": {
"jmeno": "Ada",
"zprava": "Ahoj"
}
}03 / Postup
Převeďte podporované mapy a seznamy YAML na JSON. Načte zdokumentovanou podmnožinu vstupu a zapíše odpovídající výstupní reprezentaci. Čtečka YAML přijímá explicitní podmnožinu vytvořenou opačným nástrojem, jednoduché necitované skaláry a přímý zápis JSON. Zkontrolujte typy výsledného JSON. Externí konfigurace s kotvami či víceřádkovými bloky potřebuje úplný parser.
JSON a YAML popisují vnořené mapy, seznamy a skalární hodnoty, ale YAML navíc nabízí kotvy, značky, blokové řetězce a pravidla implicitních typů. Směr JSON na YAML zapisuje malou explicitní podmnožinu: klíče a řetězce v uvozovkách, odsazení po dvou mezerách a čísla, boolean i null kompatibilní s JSON. Opačný směr čte tuto podmnožinu, jednoduché necitované skaláry a přímý zápis JSON; netvrdí, že parsuje každý platný dokument YAML. Uvozovky brání náhodné změně textu true na boolean. Duplicitní klíče a chybné odsazení se odmítají. Pro pokročilé konfigurace použijte úplný YAML parser.
Změna datového formátu je mapování mezi dvěma modely informací, ne pouhá výměna interpunkce. Začněte malým reprezentativním záznamem, který podle potřeby obsahuje znak mimo ASCII, chybějící pole nebo vnořenou hodnotu. Spusťte převod a sledujte, jak se zapisují klíče, pořadí, čísla, null, pole a opakované položky. Cílový formát nemusí mít přímou obdobu některé vlastnosti zdroje; konkrétní návod popisuje podporované mapování. Výstup otevřete v cílové aplikaci a podle možnosti jej převeďte zpět k porovnání podstatných polí. Při hromadné migraci nebo externím kontraktu použijte úplný parser a testy schématu.
Původní zdroj si ponechte vedle výsledku a před velkým dokumentem vyzkoušejte krátký známý příklad. Porovnávejte významový obsah, nejen velikost souboru nebo počet řádků. Po transformaci zkontrolujte názvy, řetězce v uvozovkách, znaky mimo ASCII, konce řádků i opakovaná pole. Čitelný výsledek neověřuje schéma, nedokazuje spustitelnost kódu ani bezpečnost zveřejnění dat. Tato stránka zpracovává text v prohlížeči a ukazuje výsledek jako text, ale po vložení do jiné aplikace se uplatní její pravidla. Pokud nástroj vstup odmítne, najděte nepodporovanou konstrukci a podle potřeby použijte specializovaný parser. Při kopírování z dokumentace si všimněte typografických uvozovek, neviditelných mezer a značky pořadí bajtů na začátku textu. Tyto znaky mohou vypadat nenápadně, ale parser je může vyhodnotit jinak než běžnou mezeru nebo uvozovku.