JSON para XML

Exemplo: elementos repetidos

Entrada:

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

Saída:

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

Exemplo: wrapper de array

Mesma entrada com a estratégia “envolver arrays em <item>”:

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

Mapeamento de tipos

Atributos vs elementos

XML distingue atributos (<user id="1">) de elementos filhos (<user><id>1</id></user>). O conversor usa elementos por padrão, eles são sem perda para round-tripping. Se seu XML downstream requer atributos, use uma convenção de prefixo de chave:

• A chave JSON @id se torna um atributo XML id="..." no elemento pai.
• A chave JSON #text se torna o conteúdo de texto do elemento pai.

Essas convenções vêm dos mapeamentos BadgerFish e Parker, os dois padrões mais comuns de JSON para XML.

Regras de escape

• < -> <
• > -> >
• & -> &
• " -> " (em valores de atributos)
• ' -> ' (opcional)
• Bytes em UTF-8 são preservados, declarados no prólogo XML.

Erros comuns

• Array JSON no nível raiz. XML precisa de um único elemento raiz. O conversor envolve um array em <root> (ou qualquer nome que você escolher).
• Chaves numéricas. JSON {"1": "a"} é legal; nomes de elementos XML não podem começar com um dígito. O conversor prefixa dígitos com um sublinhado (_1) ou permite que você defina um mapeamento personalizado.
• Arrays mistos. [1, "dois", { "x": true }] não tem um mapeamento limpo. Geralmente isso significa que o JSON precisa de normalização antes da conversão.
• Documentos enormes. XML é verboso, um JSON de 10 MB pode se tornar um XML de 20-30 MB. Considere a conversão em streaming para cargas muito grandes.