JSON na XML

Czym jest konwersja JSON na XML?

JSON (JavaScript Object Notation) i XML (eXtensible Markup Language) to dwa dominujące formaty wymiany danych w tworzeniu oprogramowania. JSON używa par klucz-wartość i tablic w zwartej składni, natomiast XML opakowuje dane w tagi otwierające i zamykające z opcjonalnymi atrybutami. Konwersja JSON na XML polega na przetłumaczeniu prymitywów strukturalnych JSON — obiektów, tablic, ciągów znaków, liczb, wartości logicznych i null — na poprawnie sformułowany dokument XML z odpowiednim zagnieżdżeniem elementów.

XML pozostaje wymaganym formatem w wielu systemach korporacyjnych, rządowych interfejsach API, serwisach SOAP oraz standardach branżowych takich jak HL7 (ochrona zdrowia), FpML (finanse) i XBRL (sprawozdawczość finansowa). Gdy aplikacja generuje JSON, a odbiorca danych oczekuje XML, konwerter JSON na XML obsługuje tę translację bez ręcznej restrukturyzacji. Konwersja opiera się na przewidywalnych regułach odwzorowania: obiekty JSON stają się elementami XML, elementy tablicy stają się powtarzającymi się elementami sibling, a wartości prymitywne stają się węzłami tekstowymi.

Nie istnieje jeden RFC ani standard W3C definiujący sposób odwzorowania JSON na XML. Różne biblioteki produkują różne wyjście dla tych samych danych wejściowych. Najczęstsza konwencja (stosowana przez to narzędzie) opakowuje cały dokument w konfigurowalny element główny, przekształca każdy klucz JSON w element potomny XML i reprezentuje elementy tablicy jako powtarzające się elementy z tą samą nazwą tagu. Zrozumienie tych reguł odwzorowania ma znaczenie, gdy system odbiorczy wymusza konkretny schemat XML (XSD).

Dlaczego warto używać internetowego konwertera JSON na XML?

Ręczne pisanie XML na podstawie źródła JSON jest żmudne i podatne na błędy. Niezgodne tagi, brakujące elementy zamykające i nieprawidłowe zagnieżdżenie powodują, że dokumenty nie przechodzą walidacji schematu. Konwerter automatycznie obsługuje translację struktury.

Zastosowania konwertera JSON na XML

Reguły odwzorowania JSON na XML

Ponieważ nie istnieje powszechny standard regulujący konwersję JSON na XML, różne narzędzia produkują różne wyjście. Poniższa tabela pokazuje konwencje odwzorowania stosowane przez ten konwerter i najpopularniejsze biblioteki (js2xmlparser, xmlbuilder, fast-xml-parser). Konwencja powtarzanych elementów sibling dla tablic stała się dominująca, ponieważ odzwierciedla naturalny sposób modelowania kolekcji w schematach XML — każdy element jest pełnoprawnym elementem, a nie zagnieżdżonym potomkiem — i dobrze integruje się z zapytaniami XPath i transformacjami XSLT.

Przykłady kodu

Poniżej znajdują się działające fragmenty kodu do konwersji JSON na XML w trzech środowiskach. Każdy przykład generuje poprawnie sformułowany XML z przykładowego obiektu JSON.

import { create } from 'xmlbuilder2';

const json = {
  order: {
    id: 1024,
    items: [
      { sku: "A1", qty: 2 },
      { sku: "B3", qty: 1 }
    ],
    shipped: false
  }
};

const xml = create({ version: '1.0' })
  .ele(json)
  .end({ prettyPrint: true });

console.log(xml);
// → <?xml version="1.0"?>
// → <order>
// →   <id>1024</id>
// →   <items>
// →     <sku>A1</sku>
// →     <qty>2</qty>
// →   </items>
// →   <items>
// →     <sku>B3</sku>
// →     <qty>1</qty>
// →   </items>
// →   <shipped>false</shipped>
// → </order>

import json
import xmltodict

data = {
    "order": {
        "id": 1024,
        "items": [
            {"sku": "A1", "qty": 2},
            {"sku": "B3", "qty": 1}
        ],
        "shipped": False
    }
}

# xmltodict.unparse expects a single root key
xml = xmltodict.unparse(data, pretty=True)
print(xml)
# → <?xml version="1.0" encoding="utf-8"?>
# → <order>
# →   <id>1024</id>
# →   <items>
# →     <sku>A1</sku>
# →     <qty>2</qty>
# →   </items>
# →   <items>
# →     <sku>B3</sku>
# →     <qty>1</qty>
# →   </items>
# →   <shipped>false</shipped>
# → </order>

package main

import (
	"encoding/json"
	"encoding/xml"
	"fmt"
)

type Item struct {
	SKU string `json:"sku" xml:"sku"`
	Qty int    `json:"qty" xml:"qty"`
}

type Order struct {
	XMLName xml.Name `xml:"order"`
	ID      int      `json:"id" xml:"id"`
	Items   []Item   `json:"items" xml:"items"`
	Shipped bool     `json:"shipped" xml:"shipped"`
}

func main() {
	raw := `{"id":1024,"items":[{"sku":"A1","qty":2},{"sku":"B3","qty":1}],"shipped":false}`

	var order Order
	json.Unmarshal([]byte(raw), &order)

	out, _ := xml.MarshalIndent(order, "", "  ")
	fmt.Println(xml.Header + string(out))
	// → <?xml version="1.0" encoding="UTF-8"?>
	// → <order>
	// →   <id>1024</id>
	// →   <items>
	// →     <sku>A1</sku>
	// →     <qty>2</qty>
	// →   </items>
	// →   ...
}

Często zadawane pytania