Преобразование JSON в XML

Пример: повторяющиеся элементы

Ввод:

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

Результат:

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

Пример: оболочка массива

Тот же входной набор данных с использованием стратегии «обёртывание массивов в <item>»:

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

Маппинг типов

Атрибуты по сравнению с элементами

XML различает атрибуты (<user id="1">) и дочерние элементы (<user><id>1</id></user>). По умолчанию конвертер использует элементы, они не теряют данные при обратном преобразовании. Если ваш последующий XML требует атрибутов, используйте соглашение о префиксах ключей:

• Ключ JSON @id превращается в атрибут XML id="..." у родительского элемента.
• Ключ JSON #text становится текстовым содержимым родительского элемента.

Эти соглашения взяты из схем отображения BadgerFish и Parker, двух наиболее распространённых стандартов преобразования JSON в XML.

Правила экранирования

• < -> <
• > -> >
• & -> &
• " → " (в значениях атрибутов)
• ' → ' (по желанию)
• Байты в кодировке UTF-8 сохраняются и объявляются в прологе XML.

Распространённые ошибки

• Массив JSON на корневом уровне. XML требует одного корневого элемента. Конвертер оборачивает массив в <root> (или любое выбранное вами имя).
• Числовые ключи. JSON {"1": "a"} допустим, но имена элементов XML не могут начинаться с цифры. Конвертер добавляет перед цифрой подчёркивание (_1) или позволяет задать собственное отображение.
• Смешанные массивы. Для [1, "two", { "x": true }] нет однозначного отображения. Обычно это означает, что JSON нужно нормализовать перед преобразованием.
• Огромные документы. XML многословен: JSON размером 10 МБ может стать XML размером 20–30 МБ. Для очень больших данных рассмотрите потоковое преобразование.