Convertor JSON în XML

JSON în XML și înapoi: un convertor practic pentru două lumi de date

Majoritatea dezvoltatorilor lucrează atât cu XML, cât și cu JSON, fie că vor sau nu. API-urile web moderne vorbesc aproape exclusiv JSON, dar în momentul în care atingi o bancă, un asigurător, un endpoint guvernamental, un ERP enterprise sau un serviciu SOAP vechi, XML reapare. Convertorul JSON în XML de pe această pagină transformă JSON în XML și XML înapoi în JSON direct în browserul tău, astfel încât te poți deplasa între aceste două formate fără să copiezi payload-uri sensibile într-un serviciu la distanță.

Ce sunt de fapt XML și JSON

XML (Extensible Markup Language) este un format de marcare construit în jurul tagurilor imbricate, atributelor și spațiilor de nume. A fost proiectat pentru documente și schimb structurat de date și poartă multă mecanică: scheme (XSD), spații de nume, instrucțiuni de procesare, comentarii, secțiuni CDATA și o declarație formală în partea de sus. Acea bogăție este motivul pentru care XML încă domină în sistemele vechi și enterprise. Îl găsești în servicii web SOAP, fluxuri RSS și Atom, fișiere de configurare (Spring, Maven, configurări de aplicații .NET) și standarde de mesagerie financiară precum SWIFT și ISO 20022, unde băncile și asigurătorii continuă să facă schimb de XML în fiecare zi.

JSON (JavaScript Object Notation) este mult mai simplu: obiecte cu perechi cheie/valoare, array-uri, șiruri, numere, valori booleene și null. Se mapează aproape unu la unu pe structurile de date din aproape orice limbaj de programare, motiv exact pentru care a preluat controlul asupra API-urilor web moderne, endpoint-urilor REST, aplicațiilor mobile și fișierelor de configurare precum package.json. JSON este de obicei cu 30 până la 50 la sută mai mic decât XML-ul echivalent și se analizează vizibil mai rapid, parțial pentru că renunță la tagurile de închidere și la mecanica atributelor care fac XML-ul verbos.

Diferențele cheie care contează pentru conversie

Cele două formate se suprapun suficient pentru a se mapa unul pe celălalt, dar nu curat. Câteva diferențe structurale cauzează aproape toată frecarea:

• Atribute versus noduri copil. XML face distincție între <user id="1"> (un atribut) și <user><id>1</id></user> (un element copil). JSON nu are un asemenea concept, deci convertoarele inventează unul. Prin convenție, atributele sunt pliate într-o cheie precum @attributes sau prefixate cu @, în timp ce textul elementului ajunge într-o cheie precum #text.
• Array-uri. JSON are array-uri native. XML nu are. O listă în XML este pur și simplu același tag repetat, precum trei elemente <item> la rând. Convertoarele trebuie să deducă atunci când frații repetați ar trebui să se restrângă într-un array JSON și atunci când un singur element ar trebui să rămână un obiect simplu.
• Spații de nume. XML folosește spații de nume (prefixele xmlns:soap) pentru a evita coliziunile de nume între scheme. JSON nu are nimic echivalent, deci prefixele fie supraviețuiesc ca și caractere literale în chei, fie sunt eliminate.
• Verbozitate și metadate. XML poate atașa metadate unui nod prin atribute; JSON exprimă totul ca și chei și valori. Asta face JSON mai compact și mai ușor de citit, în timp ce XML păstrează puterea de validare prin scheme XSD.

Capcane de conversie de urmărit

Turul complet JSON în XML în JSON, așteptând un rezultat identic, este greșeala clasică. Conversia are pierderi în ambele direcții, cu excepția cazului în care controlezi regulile. Ține cont de acestea:

• Atributele se pot deforma. Când convertești JSON în XML, instrumentul are nevoie de o regulă pentru care chei devin atribute versus elemente. Când mergi în cealaltă direcție, atributele trebuie să ajungă undeva, iar acel „undeva" (prefix @, bloc @attributes) diferă între biblioteci. Dacă un parser din aval așteaptă o convenție diferită, datele arată greșit chiar dacă nimic nu s-a pierdut.
• Element singular versus array. Un flux XML cu un singur <item> produce un obiect JSON; același flux cu două elemente produce un array JSON. Codul care presupune un array se strică pe cazul cu un singur element. Aceasta este o sursă comună de bug-uri de analiză RSS și SOAP.
• Spațiile de nume se scurg sau dispar. În funcție de instrument, soap:Body poate deveni o cheie numită literal soap:Body, sau prefixul poate fi eliminat complet, schimbând sensul documentului.
• Conținut mixt și tipuri. XML tratează totul ca text, deci o valoare precum true sau 42 poate rămâne un șir după conversia în JSON, în timp ce direcția inversă nu are un loc nativ pentru comentarii sau CDATA.

De ce contează conversia doar locală

Payload-urile JSON și XML sunt adesea cel mai sensibil lucru pe care îl gestionează un dezvoltator: răspunsuri API cu token-uri, mesaje SOAP cu numere de cont, fișiere de configurare cu credențiale. Un convertor care rulează în browserul tău nu încarcă niciodată nimic din toate acestea. Analizarea și serializarea se întâmplă pe mașina ta, nimic nu este trimis către un server, iar tu poți folosi instrumentul offline odată ce pagina s-a încărcat. Pentru depanarea datelor din producție sau orice sub un regim de conformitate, aceasta este diferența dintre o verificare rapidă sigură și o scurgere accidentală de date.

Dacă trebuie să ordonezi rezultatul după aceea, combină acest instrument cu celelalte convertoare de date ale noastre, sau ordonează-ți rezultatul cu formatatorul JSON înainte de a-l preda următorului instrument din pipeline-ul tău.

Întrebări frecvente