Конвертер JSON в XML

Что такое конвертация JSON в XML и как она работает?

// Convert JSON to XML in Node.js using fast-xml-parser
import { XMLBuilder } from 'fast-xml-parser';

const data = {
  catalog: {
    product: {
      '@_id': 'P01',
      '@_category': 'electronics',
      name: 'Wireless Headphones',
      price: {
        '@_currency': 'USD',
        '#text': '79.99'
      }
    }
  }
};

const builder = new XMLBuilder({
  attributeNamePrefix: '@_',   // @_ keys become XML attributes
  textNodeName: '#text',       // #text key becomes element text content
  ignoreAttributes: false,     // process @_ attribute keys
  format: true,                // pretty-print with indentation
  indentBy: '  ',              // 2-space indent
});

const xml = builder.build(data);
console.log(xml);
// <catalog>
//   <product id="P01" category="electronics">
//     <name>Wireless Headphones</name>
//     <price currency="USD">79.99</price>
//   </product>
// </catalog>

Ключевые возможности

Примеры

{"user":{"id":42,"name":"Alice Kim","email":"alice@example.com","role":"admin","address":{"city":"Seoul","country":"KR"}}}

[{"id":1,"name":"Widget A","price":9.99},{"id":2,"name":"Widget B","price":14.99},{"id":3,"name":"Widget C","price":4.49}]

{"catalog":{"product":{"@_id":"P01","@_category":"electronics","name":"Wireless Headphones","price":{"@_currency":"USD","#text":"79.99"}}}}

Как использовать

1. 1

   Вставьте ваш JSON

   Введите или вставьте JSON-данные в поле ввода выше. Также можно нажать «Загрузить пример» — объект ответа API, нагрузка-массив или объект с атрибутами @_ и #text.

2. 2

   Смотрите XML-вывод в реальном времени

   XML мгновенно появляется в панели вывода. Объекты с одним ключом используют свой ключ в качестве корня; объекты с несколькими ключами оборачиваются в ; ключи с префиксом @_ становятся атрибутами; массивы становятся повторяющимися дочерними элементами. При необходимости настройте отступ (2 или 4 пробела).

3. 3

   Скопируйте или скачайте

   Нажмите «Скопировать», чтобы поместить XML в буфер обмена, или «Скачать», чтобы сохранить его в виде файла .xml. Для валидации или переформатирования результата вставьте его в XML Форматировщик.

Типичные ловушки конвертации

// Input: { "status": 200, "data": { "id": 1 } }
// Output: <root><status>200</status><data><id>1</id></data></root>
// Root is <root> — may not match your schema

// Wrap in a named key to control the root element
// Input: { "response": { "status": 200, "data": { "id": 1 } } }
// Output: <response><status>200</status><data><id>1</id></data></response>

// Input: [{ "id": 1 }, { "id": 2 }]
// Output: <root><item><id>1</id></item><item><id>2</id></item></root>
// Tag names are generic

// Wrap in a named key for meaningful tag names
// Input: { "products": [{ "id": 1 }, { "id": 2 }] }
// Output: <root><products><id>1</id></products><products><id>2</id></products></root>
// Each array element reuses the key name "products" as its tag

// Input: { "tag": { "id": "42", "name": "Alice" } }
// Output: <tag><id>42</id><name>Alice</name></tag>  ← id is a child element

// Use @_ prefix for attributes
// Input: { "tag": { "@_id": "42", "name": "Alice" } }
// Output: <tag id="42"><name>Alice</name></tag>  ← id is an attribute

// Input: { "price": { "@_currency": "USD", "value": "29.99" } }
// Output: <price currency="USD"><value>29.99</value></price>
// Text is a child element, not text content

// Use #text for element text content
// Input: { "price": { "@_currency": "USD", "#text": "29.99" } }
// Output: <price currency="USD">29.99</price>  ← text content

// JSON key starts with digit — invalid XML element name
// Input: { "1stItem": "value" }
// Output: <1stItem>value</1stItem>  ← invalid XML

// Use a valid XML element name
// Input: { "firstItem": "value" }
// Output: <firstItem>value</firstItem>  ← valid XML

// JSON: { "query": "name = 'Alice' & role = 'admin'" }
// Converter outputs: <query>name = 'Alice' &amp; role = 'admin'</query>
// If double-processed: &amp;amp; — consumer is re-escaping

// Converter output is correct — consume it as XML, not as a raw string
// <query>name = 'Alice' &amp; role = 'admin'</query>
// XML parser decodes to: name = 'Alice' & role = 'admin'

Типичные сценарии

Вызов SOAP и устаревших XML-веб-сервисов

Создайте JSON-нагрузку в вашем приложении, конвертируйте её в XML и отправьте POST-запрос на конечную точку SOAP. Это позволяет избежать ручного составления XML-строк и работать с данными в нативной JSON-структуре вплоть до момента сериализации для устаревшего сервиса.

Генерация XML-конфигурационных файлов

Spring, Maven, Ant, Tomcat и Android используют XML-форматы конфигурации. Генерируйте или преобразовывайте данные конфигурации в JSON — удобнее для сравнения и контроля версий — затем конвертируйте в XML для развёртывания.

Создание XML карты сайта и RSS-ленты

Системы управления контентом и генераторы статических сайтов нередко хранят метаданные страниц в JSON. Конвертируйте эти метаданные в XML карты сайта или RSS-ленты для отправки поисковым системам или синдикации контента читателям лент.

Корпоративная интеграция данных (EDI / ERP / CRM)

Системы ERP (SAP, Oracle), платформы CRM и EDI-сети обычно обмениваются данными в XML. Конвертируйте JSON-экспорты из современных REST API в XML для питания этих систем без создания специального XML-сериализатора.

Ресурсные файлы Android

Строковые ресурсы Android, ограничения компоновки и записи манифеста — всё это XML. Программно генерируйте или обновляйте ресурсные файлы из JSON-источников данных и конвертируйте в необходимый XML-формат для системы сборки Android.

Генерация SVG и векторной графики

SVG — это XML. Стройте SVG-структуру в виде JSON-данных — пути, фигуры, цвета, трансформации — затем конвертируйте в XML для создания допустимых SVG-файлов для веба, печати или инструментов векторного редактирования.

Технические детали

Разбор JSON по RFC 8259

JSON-ввод разбирается с помощью нативного JSON.parse() браузера, полностью соответствующего RFC 8259. Он предоставляет точные сообщения об ошибках синтаксиса с информацией о позиции (строка и столбец) и обрабатывает все типы данных JSON: строки, числа, булевые значения, null, массивы и объекты.

Пользовательский рекурсивный сериализатор JSON в XML

После разбора пользовательский рекурсивный сериализатор обходит JSON-дерево. Ключи объектов, начинающиеся с @_, выводятся как XML-атрибуты родительского элемента. Ключ #text выводится как текстовое содержимое элемента. Обычные ключи объектов становятся дочерними элементами. Элементы массива создают повторяющиеся одноимённые соседние элементы. Специальные символы (<, >, &, ", ') в текстовом содержимом и значениях атрибутов экранируются в их XML-символьные ссылки.

Нормализация корневого элемента

Поскольку XML требует ровно одного корневого элемента, сериализатор применяет нормализацию корня перед построением документа: объекты с одним ключом используют ключ в качестве корня; объекты с несколькими ключами и массивы верхнего уровня получают синтетическую обёртку . Это гарантирует, что вывод всегда является правильно оформленным XML независимо от формы ввода.

100% работа в браузере — без загрузки и сервера

Вся обработка выполняется в JavaScript-движке вашего браузера. Никакие данные не передаются по сети ни в какой момент. Входные данные размером более 200 КБ автоматически переключаются из режима реального времени в ручной режим (требуется явное нажатие «Конвертировать») для сохранения отзывчивости браузера при интенсивной сериализации.

Лучшие практики

Управляйте корневым элементом с помощью объекта с одним ключом

Самый чистый способ получить значимый XML — убедиться, что ваш JSON верхнего уровня является объектом с одним ключом, который является желаемым именем корневого элемента. Обёртка данных с несколькими ключами под одним именованным ключом даёт семантически значимый корень вместо универсальной обёртки .

Используйте @_ и #text для XML с большим количеством атрибутов

Если ваша целевая XML-схема использует много атрибутов (что распространено в конфигурационных файлах, SVG и SOAP-конвертах), преобразуйте JSON для использования ключей с префиксом @_ и #text перед конвертацией. Полученный XML будет точно соответствовать целевой схеме без постобработки.

Оборачивайте массивы в именованные объекты для значимых имён тегов

Массив верхнего уровня создаёт универсальный шаблон ..., где — фиксированное буквальное имя. Обёртка массива под именованным ключом — { "products": [...] } — создаёт повторяющиеся элементы (имя ключа повторно используется для каждого элемента массива) под обёрткой . Это даёт доменно-значимое имя тега и почти всегда предпочтительно для XML, который будет разбираться или валидироваться по схеме.

Валидируйте вывод с помощью XML Форматировщика

После конвертации вставьте XML-вывод в XML Форматировщик для валидации правильной оформленности, проверки отступов и выявления структурных проблем перед отправкой XML в нижестоящий сервис или его коммитом в систему контроля версий.

Нормализуйте JSON-ключи перед конвертацией

Имена XML-элементов должны начинаться с буквы или подчёркивания и не могут содержать пробелы или большинство специальных символов. Если ваши JSON-ключи поступают из внешнего источника (имя столбца базы данных, имя поля API или пользовательский ввод), проверьте их допустимость как имён XML перед конвертацией, чтобы избежать некорректного вывода.

Часто задаваемые вопросы