Объединение JSON

Похожие

Что такое объединение JSON (JSON Merge)?

Варианты использования

• Объединение ответов API от нескольких микросервисов в единую JSON-структуру для использования фронтендом
• Агрегация многоуровневых конфигурационных файлов base/dev/prod с перекрытием по окружению для генерации итогового конфига
• Слияние, дедупликация и дополнение нескольких i18n-файлов переводов по языкам в полный словарь
• Объединение нескольких массивов mock-данных или ответов пагинированных API в полный набор данных
• Слияние дефолтной конфигурации фронтенд-компонента + пользовательских настроек + удалённой конфигурации A/B-экспериментов
• При миграции данных объединение JSON-экспортов из нескольких исходных систем в единый формат для последующей обработки

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

1. Вставьте от 2 до N фрагментов JSON для объединения последовательно в левые поля ввода (по умолчанию 2 поля) или нажмите «+» для добавления новых полей
2. Выберите стратегию слияния в выпадающем списке на панели инструментов: глубокое слияние (Deep) / поверхностное слияние (Shallow) / конкатенация массивов (Array Concat) / замена массивов (Array Replace)
3. Нажмите кнопку «Объединить», в правом поле вывода отобразится отформатированный результат; при синтаксических ошибках во вводе будут показаны конкретный номер строки и сообщение об ошибке
4. После проверки результата нажмите «Копировать» для помещения объединённого результата в буфер обмена или «Скачать» для сохранения в файл merged.json с последующей обработкой форматированием, валидацией Schema и т.д.

Функции

• 4 стратегии слияния: глубокое слияние / поверхностное слияние / конкатенация массивов / замена массивов — переключение одним кликом для разных бизнес-сценариев
• Поддержка от 2 до N фрагментов JSON: по умолчанию 2 поля ввода, можно нажимать «+» для динамического добавления исходных JSON, гибкая адаптация к многоисточниковой агрегации
• Глубокое рекурсивное слияние: интеллектуальная обработка многоуровневых вложенных объектов, разрешение конфликтов листовых узлов по выбранной стратегии с сохранением всех валидных полей
• Гибкое разрешение конфликтов: конфликты верхнего уровня разрешаются по выбранной стратегии; конфликты вложенных объектов обрабатываются глубоким слиянием; конфликты массивов обрабатываются через arrayConcat/arrayReplace
• Единое форматирование вывода: результат слияния отображается с отступом в 2 пробела, удобно для ручного просмотра и прямого копирования в последующие инструменты
• Слияние в реальном времени: после вставки нажмите «Объединить» для получения результата, при ошибках отображаются конкретный номер строки JSON и сообщение об ошибке
• Локальная обработка для защиты приватности: парсинг, слияние и форматирование полностью выполняются локально в браузере, вводимые данные не отправляются ни на какие серверы
• Бесшовная интеграция с последующими инструментами: результат слияния можно одним кликом скопировать в инструменты форматирования JSON, валидации Schema, генерации кода и другие для дальнейшей обработки

Примеры кода

// npm install lodash.merge
import merge from 'lodash.merge';

const a = { user: { name: 'Alice', age: 28 }, tags: ['admin'] };
const b = { user: { email: 'a@x.com', age: 29 }, tags: ['editor'] };

// Глубокое слияние: вложенные объекты рекурсивно объединяются, листовые узлы последующего ввода перезаписывают предыдущие
const deep = merge({}, a, b);
console.log(deep);
// => { user: { name: 'Alice', age: 29, email: 'a@x.com' }, tags: ['admin', 'editor'] }

// Поверхностное слияние: ключи верхнего уровня перезаписываются целиком, без входа во вложенные структуры
const shallow = Object.assign({}, a, b);
console.log(shallow);
// => { user: { email: 'a@x.com', age: 29 }, tags: ['editor'] }

# pip install mergedeep
from mergedeep import merge

a = {"user": {"name": "Alice", "age": 28}, "tags": ["admin"]}
b = {"user": {"email": "a@x.com", "age": 29}, "tags": ["editor"]}

# Глубокое слияние
result = merge(a, b)
print(result)
# => {'user': {'name': 'Alice', 'age': 29, 'email': 'a@x.com'}, 'tags': ['admin', 'editor']}

# Примечание: mergedeep по умолчанию объединяет массивы, строки/числа перезаписывает
# Для замены массивов добавьте strategy='override'

# Объединение нескольких JSON-массивов в один длинный массив
jq -s 'add' a.json b.json c.json

# Рекурсивное объединение нескольких JSON-объектов (jq 1.6+)
jq -s 'reduce .[] as $item ({}; . * $item)' a.json b.json

# Поверхностное слияние: ключи верхнего уровня из b перекрывают a
jq -s '.[0] * .[1]' a.json b.json

# После объединения массивов оставить только уникальные по полю id
jq -s '[.[].items[]] | unique_by(.id)' a.json b.json

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

Устранение неполадок

Глоссарий

JSON Merge

Операция объединения двух или более JSON-объектов по заданным правилам в один новый объект; основная сложность — «стратегия разрешения конфликтов имён ключей».

Deep Merge / Глубокое слияние

Стратегия с рекурсивным обходом вложенных объектов и слиянием по каждому листовому узлу; если обе стороны — обычные объекты, выполняется рекурсия, иначе — перезапись.

Shallow Merge / Поверхностное слияние

Стратегия, при которой сливаются только ключи верхнего уровня, одноимённые ключи перезаписываются целиком; в JS эквивалентна `Object.assign({}, a, b)`.

Array Concat / Конкатенация массивов

Одна из стратегий работы с массивами: несколько массивов объединяются в один длинный с сохранением порядка всех элементов; часто используется для агрегации ответов API.

Array Replace / Замена массивов

Одна из стратегий работы с массивами: одноимённые массивы полностью заменяются последним введённым значением; часто используется для перекрытия конфигов.

Object.assign

Встроенный метод JavaScript, копирующий все перечисляемые собственные свойства из одного или нескольких исходных объектов в целевой объект; де-факто стандартная реализация поверхностного слияния.

lodash.merge

Функция глубокого слияния из библиотеки Lodash, наиболее часто используемая реализация deep merge в экосистеме Node.js; массивы объединяются, а не перезаписываются.

mergedeep (Python)

Библиотека глубокого слияния для экосистемы Python, устанавливается через pip install mergedeep; поддерживает параметр strategy для управления поведением объединения/замены массивов.

jq -s 'add'

Команда jq, складывающая несколько JSON-массивов в один; для объединения JSON-объектов используется `reduce .[] as $item ({}; . * $item)`.

BFF (Backend for Frontend)

Агрегационный слой между фронтендом и бэкенд-сервисами в микросервисной архитектуре; часто требует объединения JSON-ответов от нескольких сервисов в единый ответ — классический сценарий JSON Merge.

Сравнение 4 стратегий объединения JSON

Таблица сравнения распространённых реализаций JSON Merge

Authoritative References

• MDNObject.assign — документация MDN Web Docs
• LodashLodash _.merge — официальная документация
• jqjq — официальное руководство: reduce и add
• IETFОфициальная спецификация JSON (RFC 8259)