Sploštiť objekt JSON

Čo prevod mení

Zmení vnorené vlastnosti na kľúče ciest JSON Pointer. Prejde vnorené objekty a polia aj skalárne hodnoty ponechá ako listy.

Pracovný príklad

Začnite vstupom zobrazeným na tejto stránke: {"pouzivatel":{"meno":"Ahoj","sprava":"Vitaj"},"aktivny":true}. Nástroj vytvorí: { "/pouzivatel/meno": "Ahoj", "/pouzivatel/sprava": "Vitaj", "/aktivny": true }. Najprv skúste príklad a porovnajte obe reprezentácie. Potom ho nahraďte vlastnými údajmi. Výsledok je text, ktorý možno skopírovať do editora, testu či požiadavky až po overení, že cieľ očakáva rovnaký tvar.

Pravidlá a hranice formátu

Sploštenie používa tokeny JSON Pointer podľa RFC 6901 pre názvy vlastností: lomka oddeľuje úrovne, vlnovka v názve sa mení na ~0 a lomka na ~1. Ide o zápis ciest, nie o všeobecnú kompresiu JSON. Polia ostávajú celé listové hodnoty, aby sa číselné kľúče objektu nepomýlili s indexmi poľa; listami ostávajú aj skaláre a prázdne objekty. Opačný smer prijíma plochý objekt s takýmito cestami, vytvorí vnorené objekty a odmietne konfliktné cesty. Prázdny koreňový objekt predstavuje prázdna cesta s prázdnym objektom. Táto úmyselne obmedzená mapa robí obojsmerný prevod predvídateľným. Pred aktualizáciou databázy porovnajte výsledok so zdrojom: lomka v kľúči sa musí escapovať a cesta nemôže prechádzať existujúcim skalárom.

Kontrola výsledku

Pri kontrole nechajte pôvodný text vedľa prevedeného. Najprv porovnajte malý známy prípad, ideálne s interpunkciou, znakom mimo ASCII, opakovanou hodnotou alebo prázdnym poľom, ktoré je pre vaše dáta dôležité. Čitateľný výstup nedokazuje, že cieľový program prijíma rovnakú schému alebo rovnaké zvyklosti. Pri výmene dát medzi aplikáciami spustite parser cieľovej aplikácie a po importe skontrolujte niekoľko záznamov. Dôležité zdrojové súbory držte vo verziovacom systéme, aby sa zmeny dali vrátiť. Spracovanie prebieha v prehliadači; táto stránka neposiela vložený obsah konverznému serveru. Pamäť prehliadača a schránka však na zdieľanom zariadení stále vyžadujú bežnú opatrnosť.

Zdroj a výsledok majú odlišnú úlohu, aj keď vyzerajú podobne. Vyššie uvedený postup opisuje podporovanú podmnožinu, nie všetky rozšírenia formátu. Pri prísnom cieľovom systéme najprv vyskúšajte malý známy prípad a až potom meňte mnoho záznamov. Ak overenie zlyhá, vráťte sa k zdroju a prvej nahlásenej chybe; oprava iba výstupu môže zakryť príčinu.

Pre spoľahlivý obojsmerný prevod sploštite objekt a pred opravou či importom obnovte vytvorené cesty. Porovnajte zrekonštruovanú štruktúru JSON vrátane prázdnych objektov, polí a názvov s lomkami alebo vlnovkami. Neupravujte ručne predponu cesty na listovú hodnotu: opačný nástroj odmietne prekrývajúce sa cesty aj potomkov pod listom.