Řádky JSON na pole

Co převod mění

Spojí jednu hodnotu JSON na řádek do pole JSON. Načte každý řádek zvlášť a zapíše čitelné pole.

Pracovní příklad

Začněte vstupem zobrazeným na této stránce: {"jmeno":"Ahoj","zprava":"Vítej"} {"jmeno":"Vítej"}. Nástroj vytvoří: [ { "jmeno": "Ahoj", "zprava": "Vítej" }, { "jmeno": "Vítej" } ]. 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 Lines ukládá jednu úplnou hodnotu JSON na řádek, takže záznamy lze snadno streamovat či zkoumat. Každý řádek se načte samostatně; prázdný řádek uprostřed se odmítne, protože neobsahuje hodnotu JSON. Koncový nový řádek je povolen. Opačný směr přijme pole JSON a každou položku zapíše jako jednu kompaktní hodnotu. Nové řádky uvnitř řetězce JSON zůstávají escapované zpětným lomítkem a písmenem n, takže záznam nerozdělí. Hodnotou na nejvyšší úrovni může být objekt, pole, číslo, řetězec, logická hodnota nebo null, ačkoli cílová služba může vyžadovat jen objekty. Výsledné pole je jeden dokument JSON; řádková podoba obsahuje více dokumentů a nehodí se pro API čekající jednu hodnotu. Před velkým exportem ověřte UTF-8 a limity velikosti záznamů.

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.

Vytvořené JSON Lines ověřte načtením každého neprázdného řádku zvlášť; vytvořené pole ověřte jedním načtením celého dokumentu JSON. Nové řádky v řetězcích nechte escapované, aby nevznikly nechtěné hranice záznamů. Pokud cílová služba vyžaduje objekt v každém řádku, ověřte tento požadavek výslovně, protože formát povoluje i skaláry. Mnohé řádkové čtečky přijímají závěrečný nový řádek.