Převodník JSON na XML

JSON na XML a zpět: praktický konvertor pro dva datové světy

Většina vývojářů pracuje s XML i JSON, ať chtějí nebo ne. Moderní webová API mluví téměř výhradně JSON, ale ve chvíli, kdy se dotknete banky, pojišťovny, vládního rozhraní, podnikového ERP nebo staré služby SOAP, se znovu objeví XML. Konvertor JSON na XML na této stránce převádí JSON na XML a XML zpátky na JSON přímo ve vašem prohlížeči, takže se mezi těmito dvěma formáty můžete pohybovat, aniž byste kopírovali citlivé payloady do vzdálené služby.

Co XML a JSON vlastně jsou

XML (Extensible Markup Language) je značkovací formát postavený na vnořených tazích, atributech a jmenných prostorech. Byl navržen pro dokumenty a strukturovanou výměnu dat a nese s sebou spoustu mechaniky: schémata (XSD), jmenné prostory, procesní instrukce, komentáře, sekce CDATA a formální deklaraci nahoře. Právě tato bohatost je důvod, proč XML stále dominuje ve starších a podnikových systémech. Najdete ho ve webových službách SOAP, RSS a Atom kanálech, konfiguračních souborech (Spring, Maven, konfiguracích aplikací .NET) a finančních zprávových standardech jako SWIFT a ISO 20022, kde si banky a pojišťovny stále každý den vyměňují XML.

JSON (JavaScript Object Notation) je mnohem jednodušší: objekty s dvojicemi klíč/hodnota, pole, řetězce, čísla, booleovské hodnoty a null. Mapuje se téměř jedna ku jedné na datové struktury téměř každého programovacího jazyka, což je přesně důvod, proč ovládl moderní webová API, koncové body REST, mobilní aplikace a konfigurační soubory jako package.json. JSON je typicky o 30 až 50 procent menší než ekvivalentní XML a parsuje se znatelně rychleji, částečně proto, že vynechává uzavírací tagy a mechaniku atributů, kvůli kterým je XML zdlouhavé.

Klíčové rozdíly, na kterých při konverzi záleží

Oba formáty se překrývají natolik, že se dají na sebe namapovat, ale ne čistě. Za téměř veškeré tření mohou pár strukturálních rozdílů:

• Atributy versus podřízené uzly. XML rozlišuje mezi <user id="1"> (atribut) a <user><id>1</id></user> (podřízený element). JSON žádný takový koncept nemá, takže si ho konvertory musí vymyslet. Podle konvence se atributy skládají do klíče jako @attributes nebo se prefixují znakem @, zatímco textový obsah elementu skončí v klíči jako #text.
• Pole. JSON má nativní pole. XML ne. Seznam v XML je jednoduše stejný tag opakovaný vícekrát, jako tři elementy <item> za sebou. Konvertory musí odvodit, kdy se mají opakující se sourozenci sbalit do pole JSON a kdy má jediný element zůstat obyčejným objektem.
• Jmenné prostory. XML používá jmenné prostory (prefixy typu xmlns:soap) k předcházení kolizím názvů napříč schématy. JSON nemá nic ekvivalentního, takže prefixy buď přežijí jako doslovné znaky v klíčích, nebo se odstraní.
• Zdlouhavost a metadata. XML může k uzlu připojit metadata pomocí atributů; JSON vyjadřuje vše jako klíče a hodnoty. Díky tomu je JSON kompaktnější a snáze čitelný, zatímco XML si díky schématům XSD zachovává validační sílu.

Úskalí konverze, na která si dát pozor

Klasickou chybou je proces JSON na XML a zpátky na JSON a očekávat totožný výsledek. Konverze je ztrátová v obou směrech, pokud pravidla nemáte pod kontrolou sami. Mějte na paměti:

• Atributy se pomíchají. Když převádíte JSON na XML, nástroj potřebuje pravidlo, které klíče se stanou atributy a které elementy. Když jdete opačným směrem, atributy musí někam skončit, a toto „někam" (prefix @, blok @attributes) se mezi knihovnami liší. Pokud navazující parser očekává jinou konvenci, data vypadají špatně, i když se nic neztratilo.
• Jeden element versus pole. Kanál XML s jedním <item> vytvoří objekt JSON; stejný kanál se dvěma položkami vytvoří pole JSON. Kód, který předpokládá pole, se rozbije na případu s jednou položkou. To je běžný zdroj chyb při parsování RSS a SOAP.
• Jmenné prostory unikají nebo mizí. V závislosti na nástroji se soap:Body může stát klíčem doslovně pojmenovaným soap:Body, nebo se prefix úplně odstraní, čímž se změní význam dokumentu.
• Smíšený obsah a typy. XML zachází se vším jako s textem, takže hodnota jako true nebo 42 může po konverzi na JSON zůstat řetězcem, zatímco opačný směr nemá žádné nativní místo pro komentáře nebo CDATA.

Proč záleží jen na lokální konverzi

Payloady JSON a XML bývají často to nejcitlivější, s čím vývojář pracuje: odpovědi API s tokeny, zprávy SOAP s čísly účtů, konfigurační soubory s přihlašovacími údaji. Konvertor, který běží ve vašem prohlížeči, nic z toho nikdy nenahraje. Parsování a serializace probíhají na vašem počítači, nic se neposílá na server a nástroj lze používat offline, jakmile se stránka jednou načte. Pro ladění produkčních dat nebo cokoli podléhajícího předpisům je to rozdíl mezi bezpečnou rychlou kontrolou a náhodným únikem dat.

Pokud potřebujete výsledek pak ještě vyčistit, spárujte tento nástroj s naší nabídkou konvertorů dat, nebo výstup upravte formátovačem JSON, než ho předáte dalšímu nástroji ve vaší pipeline.

Často kladené otázky