Escapovať token JSON Pointer

Čo prevod mení

Escapuje názov vlastnosti ako úsek JSON Pointer. Najprv nahradí vlnovku za ~0 a potom lomku za ~1.

Pracovný príklad

Začnite vstupom zobrazeným na tejto stránke: meno/a~b. Nástroj vytvorí: meno~1a~0b. 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

JSON Pointer tvorí postupnosť referenčných tokenov oddelených doslovnými lomkami. Táto stránka mení jeden token, nie celý pointer ani fragment URL. RFC 6901 vyhradzuje vo vnútri tokenu dva znaky: vlnovka sa píše ~0 a lomka ~1. Pri dekódovaní treba spracovať ~1 pred ~0, takže z ~01 vznikne ~1, nie lomka. Iné sekvencie s vlnovkou sú neplatné a odmietnu sa. Pre celý pointer escapujte každý názov vlastnosti osobitne a tokeny spojte s úvodnou lomkou. Prázdny token je povolený a označuje vlastnosť s prázdnym názvom; nie je to chýbajúci token. Nepoužívajte namiesto toho všeobecné URL kódovanie: percentové úniky patria do reprezentácie fragmentu URI a do inej vrstvy.

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.

Na overenie tokenu Pointer escapujte názov vlastnosti a výstup znova dekódujte; získaný text sa musí presne zhodovať vrátane vlnoviek a lomiek. Pri skladaní celého JSON Pointer umiestnite lomky medzi už escapované tokeny. Úvodná lomka patrí do cesty, nie do tokenu zadávaného tu. Osobitne otestujte vstup ~1, pretože poradie dekódovania je dôležité.