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

VeröffentlichtToolXML-JSON-Konverter

Inhalt
  1. Das Problem
  2. Die Lösung
  3. Typische Stolpersteine
  4. Zusammenfassung
  5. Häufig gestellte Fragen

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 @attributes ab. ③ 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.

XML-JSON-Konverter

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

SituationGrund
Bei nur einem gleichnamigen Kindelement kommt ein Objekt statt eines Arrays herausErst 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ührungszeichenXML-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 TagAttribute 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 JSONDa es kein umschließendes Tag gibt, erzeugt der Konverter automatisch ein Tag namens root, das alles umschließt
JSON-Wert ist nullWird 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 @attributes und verbleibenden Text unter #text ab.
  • 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.
XML-JSON-Konverter

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

Ähnliche Artikel

  1. Wohlgeformtes XML: Warum XML strenger als HTML parstBrowser reparieren HTML-Fehler, XML wird bei einem einzigen Fehler komplett abgelehnt. Die Regeln der Wohlgeformtheit und wie Sie Parsing-Fehler finden.
  2. YAML in JSON umwandeln: Regeln, Fehlerquellen, PrüfungWarum Code und API-Anfragen JSON statt YAML erwarten, wie die Umwandlung von Hand funktioniert und an welchen Stellen leicht Fehler passieren.
  3. YAML-Einrückungsfehler: Warum die CI-Pipeline fehlschlägtWarum ein einziges Leerzeichen in GitHub Actions oder GitLab CI den Deploy scheitern lässt und wie Sie die falsch eingerückte Zeile sofort finden.
  4. YouTube automatische Untertitel: Fehler, SRT oder VTT wählenWarum automatisch erzeugte YouTube-Untertitel bei Namen und Fachbegriffen danebenliegen, wie sie sich von manuellen unterscheiden und wann SRT, VTT oder TXT passt.
  5. Zeilennummern hinzufügen: 5 Formate und führende NullenSo nummerieren Sie Zeilen in Text oder Code automatisch, etwa als 1., [1] oder 01., lassen Leerzeilen aus und verstehen, wie die Stellenzahl berechnet wird.
  6. Anagramm prüfen: Anleitung und Algorithmus im ÜberblickAnagramme erkennen in vier Schritten: Zeichen bereinigen, sortieren, vergleichen. Dazu ein schneller Algorithmus mit Hashmap.

Passende Tools