JSON vers XML

Qu'est-ce que la conversion JSON vers XML ?

JSON (JavaScript Object Notation) et XML (eXtensible Markup Language) sont les deux formats d'échange de données dominants en développement logiciel. JSON utilise des paires clé-valeur et des tableaux dans une syntaxe compacte, tandis que XML enveloppe les données dans des balises ouvrantes et fermantes avec des attributs optionnels. Convertir du JSON en XML signifie traduire les primitives structurelles de JSON — objets, tableaux, chaînes, nombres, booléens et null — en un document XML bien formé avec une imbrication d'éléments correspondante.

XML reste le format obligatoire dans de nombreux systèmes d'entreprise, API gouvernementales, services web SOAP et standards industriels comme HL7 (santé), FpML (finance) et XBRL (reporting financier). Lorsque votre application produit du JSON mais que le système destinataire attend du XML, un convertisseur JSON vers XML prend en charge la traduction sans restructuration manuelle. La conversion suit des règles de correspondance prévisibles : les objets JSON deviennent des éléments XML, les éléments de tableau deviennent des éléments frères répétés, et les valeurs primitives deviennent des nœuds texte.

Il n'existe pas de RFC ou de standard W3C unique définissant comment JSON se mappe vers XML. Différentes bibliothèques produisent des sorties différentes pour la même entrée. La convention la plus répandue (utilisée par cet outil) enveloppe l'ensemble du document dans un élément racine configurable, convertit chaque clé JSON en élément XML enfant, et représente les éléments de tableau comme des éléments répétés portant le même nom de balise. Comprendre ces règles de correspondance est important lorsque le système destinataire impose un schéma XML (XSD) précis.

Pourquoi utiliser un convertisseur JSON vers XML en ligne ?

Rédiger du XML à la main à partir d'une source JSON est fastidieux et source d'erreurs. Des balises mal fermées, des éléments oubliés et une imbrication incorrecte produisent des documents qui échouent à la validation de schéma. Un convertisseur gère la traduction structurelle automatiquement.

Cas d'utilisation de JSON vers XML

Règles de correspondance JSON vers XML

Comme aucun standard universel ne régit la conversion JSON vers XML, différents outils produisent des sorties différentes. Le tableau ci-dessous présente les conventions de correspondance utilisées par ce convertisseur et la plupart des bibliothèques populaires (js2xmlparser, xmlbuilder, fast-xml-parser). La convention des éléments frères répétés pour les tableaux est devenue dominante car elle reflète la façon dont les schémas XML modélisent naturellement les collections — chaque élément est un élément de premier plan plutôt qu'un enfant enveloppé — et s'intègre proprement avec les requêtes XPath et les transformations XSLT.

Exemples de code

Voici des extraits exécutables pour convertir du JSON en XML dans trois environnements. Chaque exemple produit un XML bien formé à partir d'un objet JSON exemple.

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>
	// →   ...
}

Questions fréquentes