JSON in XML

Esempio: elementi ripetuti

Input:

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

Output:

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

Esempio: wrapper per array

Stesso input con la strategia “avvolgi gli array in <item>”:

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

Mappatura dei tipi

Attributi vs elementi

XML distingue gli attributi (<user id="1">) dagli elementi figli (<user><id>1</id></user>). Il convertitore predefinito utilizza elementi, sono senza perdita per il round-tripping. Se il tuo XML downstream richiede attributi, utilizza una convenzione di prefisso per le chiavi:

• La chiave JSON @id diventa un attributo XML id="..." sull’elemento padre.
• La chiave JSON #text diventa il contenuto di testo dell’elemento padre.

Queste convenzioni provengono dalle mappature BadgerFish e Parker, i due standard più comuni per JSON-to-XML.

Regole di escape

• < -> <
• > -> >
• & -> &
• " -> " (nei valori degli attributi)
• ' -> ' (opzionale)
• I byte in UTF-8 sono preservati, dichiarati nel prologo XML.

Errori comuni

• Array JSON a livello radice. XML ha bisogno di un singolo elemento radice. Il convertitore avvolge un array in <root> (o qualunque nome tu scelga).
• Chiavi numeriche. JSON {"1": "a"} è legale; i nomi degli elementi XML non possono iniziare con una cifra. Il convertitore antepone le cifre con un trattino basso (_1) o ti consente di definire una mappatura personalizzata.
• Array misti. [1, "due", { "x": true }] non ha una mappatura pulita. Di solito significa che il JSON ha bisogno di normalizzazione prima della conversione.
• Documenti enormi. XML è verboso, un JSON di 10 MB può diventare un XML di 20-30 MB. Considera la conversione in streaming per payload molto grandi.