Riadky JSON na pole

Čo prevod mení

Spojí jednu hodnotu JSON na riadok do poľa JSON. Načíta každý riadok osobitne a zapíše čitateľné pole.

Pracovný príklad

Začnite vstupom zobrazeným na tejto stránke: {"meno":"Ahoj","sprava":"Vitaj"} {"meno":"Vitaj"}. Nástroj vytvorí: [ { "meno": "Ahoj", "sprava": "Vitaj" }, { "meno": "Vitaj" } ]. 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 Lines ukladá jednu úplnú hodnotu JSON na riadok, takže záznamy sa dajú ľahko streamovať či skúmať. Každý riadok sa načíta samostatne; prázdny riadok uprostred sa odmietne, lebo neobsahuje hodnotu JSON. Koncový nový riadok je povolený. Opačný smer prijme pole JSON a každú položku zapíše ako jednu kompaktnú hodnotu. Nové riadky vo vnútri reťazca JSON ostávajú escapované spätnou lomkou a písmenom n, takže záznam nerozdelia. Hodnotou na najvyššej úrovni môže byť objekt, pole, číslo, reťazec, logická hodnota alebo null, hoci cieľová služba môže vyžadovať len objekty. Výsledné pole je jeden dokument JSON; riadková podoba obsahuje viac dokumentov a nehodí sa pre API čakajúce jednu hodnotu. Pred veľkým exportom overte UTF-8 a limity veľkosti záznamov.

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.

Vytvorené JSON Lines overte načítaním každého neprázdneho riadka osobitne; vytvorené pole overte jedným načítaním celého dokumentu JSON. Nové riadky v reťazcoch nechajte escapované, aby nevznikli nechcené hranice záznamov. Ak cieľová služba vyžaduje objekt v každom riadku, overte túto požiadavku výslovne, pretože formát povoľuje aj skaláre. Mnohé riadkové čítačky prijímajú záverečný nový riadok.