XML in JSON umwandeln: Warum Arrays und Attribute sich ändern

Wenn Sie ein JSON-Array in XML umwandeln, entsteht kein neues Tag, das das Array umschließt. Stattdessen wiederholt sich das Tag mit demselben Namen einfach so oft hintereinander, wie das Array Einträge hat. Umgekehrt landen XML-Attribute bei der Umwandlung in JSON nicht zwischen den übrigen Werten, sondern unter einem eigenen Schlüssel wie @attributes. Beides ist kein Fehler, sondern ergibt sich daraus, dass XML und JSON grundsätzlich unterschiedliche Informationsstrukturen abbilden können.
Kurzfassung ① XML kennt kein Array. Deshalb wird ein JSON-Array zu einer Folge gleichnamiger Tags ohne umschließendes Tag, und zwar so viele, wie das Array Einträge hat. ② Ein XML-Element kann gleichzeitig Attribute, Kindelemente und Text enthalten. Ein JSON-Objekt kennt diese Unterscheidung nicht, daher legt der Konverter Attribute unter einem eigenen Schlüssel wie
@attributesab. ③ Diese Schreibweise ist keine Regel aus dem XML- oder JSON-Standard, sondern eine Konvention des jeweiligen Konverters. Je nach Tool kann das resultierende JSON daher etwas anders aussehen.
Das Problem
Wenn Sie XML-Daten in JSON umwandeln und im Code weiterverwenden, stoßen Sie meist an zwei Stellen auf Probleme. Die erste: „Mehrere gleichnamige Tags ergeben ein Array – warum kommt bei nur einem Tag stattdessen ein einzelnes Objekt heraus?“ Die zweite: „Warum steht ein Attributwert wie category="cooking" nicht neben Feldern wie title und author, sondern in einem fremd wirkenden Schlüssel namens @attributes?“
In die andere Richtung ist es ähnlich. Wenn Sie JSON-Array-Daten im XML-Format ausgeben müssen, entsteht kein umschließendes Tag für das Array, sondern nur eine Wiederholung gleichnamiger Tags. Auf den ersten Blick wirkt das, als sei die Array-Struktur verloren gegangen.
Beides hat der Konverter nicht falsch gemacht. Es folgt zwangsläufig daraus, dass XML und JSON unterschiedliche Informationsformen darstellen können.
Die Lösung
Wenn Sie beide Richtungen als Regeln verstehen, können Sie die Struktur des Ergebnisses auch ohne Tool vorhersagen.
JSON-Array → XML: Warum wiederholen sich die Tags?
XML hat keinen Datentyp „Array“. Es gibt nur „Elemente“, und ein Element kann mehrfach mit demselben Namen nebeneinander auftreten. Wenn "book": [ {...}, {...} ] aus JSON nach XML übertragen wird, entsteht deshalb kein neues Tag um das Array. Stattdessen wird das Tag <book> so oft aufgeführt, wie das Array Einträge hat. Bei 2 Einträgen steht <book> zweimal da, bei 5 Einträgen fünfmal.
XML-Attribut → JSON: Warum werden Attribute in @attributes abgetrennt?
Ein XML-Element kann gleichzeitig drei Dinge enthalten: Attribute (z. B. category="cooking"), Kindelemente (z. B. <title>) und Text (die Zeichen zwischen den Tags). Ein JSON-Objekt besteht dagegen nur aus Schlüssel-Wert-Paaren und hat keine Syntax, um zu unterscheiden, ob ein Wert ein Attribut oder ein Kindelement ist. Damit diese Unterscheidung nicht verloren geht, sammelt der Konverter die Attribute unter dem eigenen Schlüssel @attributes, getrennt von Kindelementen und Text. Enthält ein Element Attribute und Text zugleich, wird der Text wiederum separat unter dem Schlüssel #text abgelegt.
Ohne Attribute und Kindelemente bleibt es ein String
Hat ein Element dagegen weder Attribute noch Kindelemente, sondern nur Text (z. B. <author>Giada De Laurentiis</author>), wird es nicht in ein Objekt verpackt. Der Wert wird direkt als String zurückgegeben. Deshalb sieht das Ergebnis so schlicht aus: {"author": "Giada De Laurentiis"}.
Bei mehreren JSON-Schlüsseln auf oberster Ebene entsteht automatisch ein umschließendes Tag
XML verlangt genau ein Wurzelelement. Hat das JSON auf oberster Ebene nur einen Schlüssel, wird dessen Name unverändert als Wurzel-Tag verwendet. Bei zwei oder mehr Schlüsseln gibt es kein Tag, das alles umschließen könnte. Der Konverter legt dann willkürlich ein Tag namens <root> an und setzt alle Schlüssel als Kindelemente hinein.
Schon mit diesen vier Regeln lässt sich meistens erklären, warum die Struktur beim Wechsel zwischen XML und JSON so aussieht, wie sie aussieht. Probieren Sie es an einem konkreten Beispiel mit unserem XML-JSON-Konverter selbst aus.
Fügen Sie XML ein, erhalten Sie sofort JSON – und umgekehrt. So prüfen Sie das Ergebnis der Konvertierung in beide Richtungen direkt selbst.

Typische Stolpersteine
| Situation | Grund |
|---|---|
| Bei nur einem gleichnamigen Kindelement kommt ein Objekt statt eines Arrays heraus | Erst wenn der gleiche Name ein zweites Mal auftaucht, wird daraus ein Array. Der nachfolgende Code kann sich daher bei einem Eintrag anders verhalten als bei zwei oder mehr |
| Werte, die wie Zahlen aussehen, erscheinen als String in Anführungszeichen | XML-Text kennt keine Datentypen, daher werden auch Werte wie 2005 oder 30.00 durchgehend als String umgewandelt |
| Attribute, Kindelemente und Text stehen gemischt in einem Tag | Attribute landen in @attributes, Kindelemente unter dem jeweiligen Tag-Namen und der verbleibende Text unter dem Schlüssel #text |
| Mehrere Schlüssel auf oberster Ebene im JSON | Da es kein umschließendes Tag gibt, erzeugt der Konverter automatisch ein Tag namens root, das alles umschließt |
| JSON-Wert ist null | Wird zu einem leeren, selbstschließenden Tag (<tag/>) |
Zusammenfassung
- Da XML kein Array kennt, wird ein JSON-Array zu einer Folge gleichnamiger Tags ohne umschließendes Tag, und zwar so vielen, wie das Array Einträge hat.
- Ein XML-Element kann gleichzeitig Attribute, Kindelemente und Text enthalten, ein JSON-Objekt kennt diese Unterscheidung nicht. Der Konverter trennt daher Attribute unter
@attributesund verbleibenden Text unter#textab. - Ein Element mit reinem Text, ohne Attribute und Kindelemente, wird nicht in ein Objekt verpackt, sondern als String-Wert ausgegeben.
- Da XML genau ein Wurzelelement verlangt, legt der Konverter bei mehreren JSON-Schlüsseln auf oberster Ebene automatisch ein root-Tag an, das alles umschließt.
- Diese Schreibweise ist keine Regel aus dem XML- oder JSON-Standard, sondern eine Konvention des Konverters. Bei einem anderen Tool können die Schlüsselnamen daher anders ausfallen.
Fügen Sie XML ein, erhalten Sie sofort JSON – und umgekehrt. So prüfen Sie das Ergebnis der Konvertierung in beide Richtungen direkt selbst.
Häufig gestellte Fragen
Kann ich erreichen, dass auch ein einzelnes Kindelement als Array ausgegeben wird?
Die aktuelle Umwandlungsregel macht erst dann ein Array daraus, wenn ein gleichnamiges Element zum zweiten Mal auftritt. Bei nur einem Element erhalten Sie daher ein einzelnes Objekt. Wenn Sie unabhängig von der Anzahl der Einträge immer mit einem Array arbeiten möchten, müssen Sie im Code nach dem Erhalt des umgewandelten JSON selbst eine Prüfung ergänzen: Ist der Wert kein Array, wird er in ein Array verpackt.
Sind die Namen @attributes und #text standardisiert?
Nein, zwischen XML und JSON gibt es keinen offiziellen Standard, der solche Namen vorschreibt. @attributes und #text sind die Schreibweise, die dieser Konverter verwendet, um Attribute und Text von anderen Werten zu unterscheiden. Andere Bibliotheken und Tools gehen teils anders vor, etwa indem sie den Attributnamen direkt mit einem @ versehen. Wenn Sie das umgewandelte JSON an ein anderes System weitergeben, sollten Sie deshalb zuerst prüfen, ob die Gegenseite dieselbe Schreibweise verwendet.
Kann ich den Namen des Wurzel-Tags bei der Umwandlung von JSON in XML frei wählen?
Hat das JSON auf oberster Ebene genau einen Schlüssel, wird dessen Name unverändert zum Wurzel-Tag. Den gewünschten Namen legen Sie also einfach über diesen Schlüssel fest. Bei mehreren Schlüsseln auf oberster Ebene gibt es kein umschließendes Tag, und es wird automatisch der Name root vergeben. Wenn Sie einen eigenen Namen möchten, verpacken Sie das JSON vor der Umwandlung einmal in der Form { "gewünschter_name": { ...übrige Schlüssel } }.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen