Escapovat token JSON Pointer

Co převod mění

Escapuje název vlastnosti jako úsek JSON Pointer. Nejprve nahradí vlnovku za ~0 a poté lomítko za ~1.

Pracovní příklad

Začněte vstupem zobrazeným na této stránce: jmeno/a~b. Nástroj vytvoří: jmeno~1a~0b. Nejprve zkuste příklad a porovnejte obě reprezentace. Potom jej nahraďte vlastními údaji. Výsledek je text, který lze zkopírovat do editoru, testu či požadavku až po ověření, že cíl očekává stejný tvar.

Pravidla a hranice formátu

JSON Pointer tvoří posloupnost referenčních tokenů oddělených doslovnými lomítky. Tato stránka mění jeden token, nikoli celý pointer ani fragment URL. RFC 6901 vyhrazuje uvnitř tokenu dva znaky: vlnovka se píše ~0 a lomítko ~1. Při dekódování je nutné zpracovat ~1 před ~0, takže z ~01 vznikne ~1, nikoli lomítko. Jiné sekvence s vlnovkou jsou neplatné a odmítnou se. Pro celý pointer escapujte každý název vlastnosti zvlášť a tokeny spojte s úvodním lomítkem. Prázdný token je povolený a označuje vlastnost s prázdným názvem; není to chybějící token. Nepoužívejte místo toho obecné URL kódování: procentové úniky patří do reprezentace fragmentu URI a do jiné vrstvy.

Kontrola výsledku

Při kontrole nechte původní text vedle převedeného. Nejprve porovnejte malý známý případ, ideálně s interpunkcí, znakem mimo ASCII, opakovanou hodnotou nebo prázdným polem důležitým pro vaše data. Čitelný výstup nedokazuje, že cílový program přijímá stejné schéma nebo stejné zvyklosti. Při výměně dat mezi aplikacemi spusťte parser cílové aplikace a po importu zkontrolujte několik záznamů. Důležité zdrojové soubory držte ve verzovacím systému, aby se změny daly vrátit. Zpracování probíhá v prohlížeči; tato stránka neposílá vložený obsah konverznímu serveru. Paměť prohlížeče a schránka však na sdíleném zařízení stále vyžadují běžnou opatrnost.

Zdroj a výsledek mají odlišnou úlohu, i když vypadají podobně. Výše uvedený postup popisuje podporovanou podmnožinu, ne všechna rozšíření formátu. U přísného cílového systému nejprve vyzkoušejte malý známý případ a teprve potom měňte mnoho záznamů. Pokud ověření selže, vraťte se ke zdroji a první nahlášené chybě; oprava jen výstupu může zakrýt příčinu.

Pro ověření tokenu Pointer escapujte název vlastnosti a výstup znovu dekódujte; získaný text se musí přesně shodovat včetně vlnovek a lomítek. Při skládání celého JSON Pointer umístěte lomítka mezi již escapované tokeny. Úvodní lomítko patří do cesty, ne do tokenu zadávaného zde. Zvlášť otestujte vstup ~1, protože pořadí dekódování je důležité.