JSON vers XML

Exemple : éléments répétés

Entrée:

{ "users": [ { "name": "Alice" }, { "name": "Bob" } ] }

Sortie:

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <users>
    <name>Alice</name>
  </users>
  <users>
    <name>Bob</name>
  </users>
</root>

Exemple : wrapper de tableau

Même entrée avec la stratégie “envelopper les tableaux dans <item>” :

<root>
  <users>
    <item>
      <name>Alice</name>
    </item>
    <item>
      <name>Bob</name>
    </item>
  </users>
</root>

Mappage des types

Attributs vs éléments

XML distingue les attributs (<user id="1">) des éléments enfants (<user><id>1</id></user>). Le convertisseur utilise par défaut des éléments, ils sont sans perte pour l’aller-retour (round-trip). Si votre XML en aval nécessite des attributs, utilisez une convention de préfixe de clé :

• La clé JSON @id devient un attribut XML id="..." sur l’élément parent.
• La clé JSON #text devient le contenu texte de l’élément parent.

Ces conventions proviennent des mappages BadgerFish et Parker, les deux normes les plus courantes de JSON à XML.

Règles d’échappement

• < -> <
• > -> >
• & -> &
• " -> " (dans les valeurs d’attribut)
• ' -> ' (optionnel)
• Les octets en UTF-8 sont préservés, déclarés dans le prologue XML.

Erreurs courantes

• Tableau JSON au niveau racine. XML a besoin d’un seul élément racine. Le convertisseur enveloppe un tableau dans <root> (ou quel que soit le nom que vous choisissez).
• Clés numériques. JSON {"1": "a"} est légal ; les noms d’éléments XML ne peuvent pas commencer par un chiffre. Le convertisseur préfixe les chiffres avec un underscore (_1) ou vous permet de définir un mappage personnalisé.
• Tableaux mixtes. [1, "deux", { "x": true }] n’a pas de mappage propre. Cela signifie généralement que le JSON nécessite une normalisation avant la conversion.
• Documents énormes. XML est verbeux, un JSON de 10 Mo peut devenir un XML de 20-30 Mo. Envisagez une conversion en streaming pour des charges très volumineuses.