Konwerter XML na JSON

Konwerter XML na JSON

Konwerter XML na JSON zamienia dokument XML (do 256 KB) na obiekt JSON: atrybuty dostają prefiks @, tekst elementu trafia pod klucz value, a powtórzone znaczniki stają się tablicami. XML dominuje w integracjach i feedach, JSON w nowoczesnych API, więc taka zamiana pozwala przenieść dane między systemami bez pisania własnego parsera.

Opcje konwersji XML na JSON

Przykład

<user id="1"><name>Anna</name></user>

Przy domyślnych ustawieniach daje:

{"user":{"@id":1,"name":{"value":"Anna"}}}

Atrybut id="1" stał się liczbą, bo konwersja typów jest domyślnie włączona. Z opcją „Prosty tekst jako wartość” wynik skraca się do {"user":{"@id":1,"name":"Anna"}}.

Jak działa konwersja XML na JSON

Konwersja zaczyna się od sparsowania tekstu XML do drzewa węzłów. Parser sprawdza poprawność składni: niedomknięty znacznik albo brak cudzysłowu w atrybucie kończy się błędem, a nie częściowym wynikiem. Narzędzie pokazuje wtedy numer linii i kolumny, fragment tej linii, oryginalny komunikat parsera i podpowiedź po polsku, np. że samotny znak & trzeba zapisać jako &.

Drugi etap to rekurencyjne przejście po drzewie. Każdy element staje się obiektem JSON. Atrybuty trafiają do tego obiektu pod kluczami z prefiksem, np. @id, a tekst wewnątrz elementu ląduje pod kluczem tekstu (domyślnie value). Jeśli ten sam znacznik występuje u jednego rodzica kilka razy, zamieniany jest na tablicę w kolejności z dokumentu. Elementy zagnieżdżone tworzą obiekty wewnątrz obiektów. Sekcje CDATA są czytane jako zwykły tekst, a spacje na brzegach tekstu są obcinane.

Ostatni krok to konwersja typów, domyślnie włączona. Liczbą staje się tylko zapis kanoniczny: bez zer wiodących, bez plusa i notacji wykładniczej, najwyżej 15 cyfr przed kropką. Dlatego 443 daje 443, ale 007, kod pocztowy 00-950 czy 1e3 zostają tekstem. Ułamek 129.00 zapisuje się jako 129, a 12.50 jako 12.5 (ta sama wartość). Słowa true i false, bez względu na wielkość liter, stają się wartościami logicznymi. Obok wyniku widać liczbę węzłów JSON, głębokość zagnieżdżenia, liczbę elementów i atrybutów oraz rozmiar XML i JSON w bajtach. Gotowy JSON kopiujesz jednym przyciskiem.

Przykład krok po kroku

1. Wklejamy dokument: <zamowienie id="1043"><klient>Anna</klient><pozycja kod="A1"><ilosc>2</ilosc></pozycja><pozycja kod="B7"><ilosc>5</ilosc></pozycja><oplacone>true</oplacone></zamowienie>
2. Element główny zamowienie staje się kluczem najwyższego poziomu "zamowienie" (opcja „Zachowaj element główny”).
3. Atrybut id="1043" zamienia się na parę "@id": 1043, czyli liczbę. Po wyłączeniu konwersji typów będzie to tekst "1043".
4. Element <klient>Anna</klient> daje "klient": {"value": "Anna"}, bo tekst elementu trafia pod klucz value.
5. Dwa znaczniki <pozycja> tworzą tablicę: "pozycja": [{"@kod": "A1", "ilosc": {"value": 2}}, {"@kod": "B7", "ilosc": {"value": 5}}]. Kolejność A1 przed B7 zostaje zachowana.
6. Element <oplacone>true</oplacone> daje "oplacone": {"value": true}, a przy wyłączonej konwersji typów {"value": "true"}.
7. Wynik w całości: {"zamowienie":{"@id":1043,"klient":{"value":"Anna"},"pozycja":[{"@kod":"A1","ilosc":{"value":2}},{"@kod":"B7","ilosc":{"value":5}}],"oplacone":{"value":true}}}
8. Z opcją „Prosty tekst jako wartość” ten sam dokument daje krótszą postać: {"zamowienie":{"@id":1043,"klient":"Anna","pozycja":[{"@kod":"A1","ilosc":2},{"@kod":"B7","ilosc":5}],"oplacone":true}}

Tabela referencyjna mapowania

Jak korzystać z konwertera

• Zacznij od gotowego przykładu (księgarnia, kanał RSS, konfiguracja), żeby zobaczyć format wyniku, a potem wklej własny dokument. Skrót Ctrl+Enter uruchamia konwersję, a zmiana opcji od razu przelicza wynik.
• Decyzję o typach podejmij przed eksportem. Konwersję typów zostaw włączoną, gdy dane pójdą do API lub bazy; wyłącz ją, gdy każda wartość ma zostać tekstem. Zera wiodące i kody pocztowe są chronione także przy włączonej opcji.
• Pojedynczy element daje obiekt, a dwa takie same – tablicę. Jeśli kod odczytujący wynik oczekuje zawsze tablicy (np. lista pozycji zamówienia, która czasem ma jedną pozycję), włącz „Zawsze tablice”.
• Prefiksu atrybutów nie wyłączaj, jeśli atrybut i element potomny mogą mieć tę samą nazwę. Przy <a id="1"><id>2</id></a> bez prefiksu element nadpisze atrybut i wartość 1 zniknie z wyniku.
• Przy błędzie składni sprawdź linię wskazaną przez narzędzie. Najczęstsze przyczyny to niedomknięty znacznik, samotny znak & i brak cudzysłowu w wartości atrybutu.

Ograniczenia i pułapki

• Treść mieszana, czyli tekst stojący obok elementów potomnych (np. akapit z pogrubieniem), nie trafia do JSON. Narzędzie ostrzega, w ilu elementach tak się stało.
• Elementy o tej samej nazwie są zbierane w jedną tablicę. <a><x>1</x><y>2</y><x>3</x></a> daje {"a":{"x":[{"value":1},{"value":3}],"y":{"value":2}}}, więc informacja, że y stał między dwoma x, ginie.
• Komentarze, instrukcje przetwarzania i deklaracja <?xml ?> nie są częścią modelu danych JSON i nie pojawiają się w wyniku.
• Deklaracje DOCTYPE i ENTITY są blokowane, a parser niczego nie pobiera z sieci (ochrona przed atakami XXE). Z dokumentu z deklaracją DOCTYPE trzeba usunąć tę linię; standardowe encje, np. &amp; i &lt;, działają.
• Limit dokumentu to 256 KB. Większy plik podziel na części. Konwersja odbywa się na serwerze, a treść XML nie jest zapisywana.
• Konwersja nie jest w pełni odwracalna: powrót do XML może dać inną kolejność elementów i bez przestrzeni nazw, dlatego JSON nie powinien być jedynym archiwum oryginału.