Однажды я проиграл день файлу конфигурации, который "changed" между двумя развертываниями. diff в моем терминале представлял собой стену красного цвета, сотни строк, и я провел час в поисках реального изменения, прежде чем понял, что конвейер развертывания переформатировал файл: повторно отступил его, переупорядочил несколько атрибутов, переобернул несколько длинных строк. Ни один байт, который бы волновал парсера, на самом деле не изменился, за исключением одного значения, скрытого в шуме. линейный diff не мог мне этого сказать, потому что линейный diff не понимает XML. Это руководство о сравнении XML так, как он заслуживает сравнения, с использованием Проверка различий XML на Toolz.dev, и почему структурное сравнение находит одно изменение, которое имеет значение, вместо того, чтобы заглушать его в форматирование.
TL;DR: XML diff сравнивает два документа как деревья узлов, а не как строки текста, поэтому повторное отступление, изменение порядка атрибутов или переобертка строк не регистрируется как изменение. Он сообщает, какие элементы, атрибуты и текстовые значения были добавлены, удалены или изменены, каждый из которых прикреплен к пути узла. Проверка различий XML делает это полностью в вашем браузере, ничего не загружая.
Что такое проверка различий XML?
Проверка различий XML сравнивает два XML-документа и сообщает, что изменилось как набор структурных различий: какие элементы появились или исчезли, какие атрибуты изменили значение и где текстовое содержимое отличается. Вместо сравнения файлов построчно, он анализирует оба в деревья узлов и сравнивает их как данные. Вы вставляете оригинал слева, новую версию справа и получаете обратно список различий, каждое из которых помечено точным путем в дереве, где это произошло.
Смысл структурного сравнения в том, что XML несет одинаковое значение в множестве различных байтовых раскладов The Спецификация W3C XML является явным, что некоторые поверхностные детали не влияют на анализируемый документ: порядок атрибутов на элементе не является существенным, а пробелы между элементами обычно являются просто форматированием. два файла могут быть структурно идентичными, но отличаться отступом, порядком атрибутов, окончаниями строк или тем, записан ли пустой элемент как <tag></tag> или <tag/>. Простой текстовый разметка все это отмечает; структурный разметка игнорирует его и показывает только то, что анализатор на самом деле будет читать по-другому.
На Toolz.dev рабочий процесс короткий Вставить оба документа, выбрать, игнорировать ли пробелы, атрибуты или случай, и нажать Сравнить. инструмент анализирует оба дерева и перечисляет каждое различие по пути, сгруппированные в добавленные, удаленные и измененные, со старыми и новыми значениями рядом.
Чем XML-дифф отличается от текстового?
Текстовый разметка, типа встроенная в Git и большинство редакторов, сравнивает файлы как последовательности строк и находит кратчайший набор вставок и удалений, которые превращают одно в другое. это точно правильно для исходного кода, где строки являются значимыми единицами. Это неправильная модель для XML, где смысл живет в дереве, а разрывы строк являются украшением.
Режимы сбоев предсказуемы. Отмените документ и текстовый дифференциал почти на каждую измененную строку. Измените порядок двух атрибутов на одном элементе, и он пометит эту строку, даже если элемент идентичен синтаксическому анализатору. Добавьте одного ребенка вверху, и каждая строка под ним сдвинется, чтобы в диф отображался каскад ходов, которые на самом деле не меняются. В конечном итоге вы сканируете сотни помеченных строк, чтобы найти ту, которая имеет значение, а именно день, который я описал выше.
Структурный разност обходит все это, сначала анализируя. Он строит дерево из каждого документа, затем ходит по двум деревьям вместе, сравнивая узлы. Различия в форматировании просто не существуют на уровне дерева, поэтому они не могут появиться на выходе. что остается, так это набор изменений, которые изменят поведение программного обеспечения, потребляющего XML, что почти всегда является набором, который вас действительно волнует. Если ваши данные JSON, а не XML, применяется тот же принцип и JSON диф инструмент проводит там эквивалентное структурное сравнение.
Как он решает, что изменилось?
Сравнение происходит в три слоя на каждом элементе, и их разделение делает выходные данные читаемыми.
Атрибуты сравниваются по имени, независимо от порядка их появления в теге, поскольку порядок атрибутов не является значимым в XML. Для каждого элемента инструмент проверяет, какие атрибуты существуют с обеих сторон, и сообщает об изменении атрибута, когда его значение отличается, добавляется, когда он появляется только справа, или удаляется, когда он появляется только слева. Изменение порядка <a x="1" y="2"/> на <a y="2" x="1"/> не дает никакой разницы.
Содержимое текста сравнивается как прямой текст каждого элемента. при включенной обработке пробелов пробелы и новые строки свертываются, а ведущая и конечная пробелы обрезаются, поэтому красивая печать документа не приводит к фантомным изменениям текста. Сообщается только о подлинном изменении слов между тегами.
Дочерние элементы - интересная часть Элементы, которые имеют общее имя тега, парные по порядку их появления: первый <item> слева сравнивается с первым <item> справа, со второго по второй, и так далее, Когда одна сторона имеет больше вхождений, чем другая, дополнительные сообщается как добавленные или удаленные, а не принуждение к смещению. это правило упорядочения является тем, что удерживает небольшое изменение в одном повторяющемся элементе от каскадного в диф каждого брата или сестры.
Вот как складываются две модели сравнения:
| Аспект | Текстовый дифф | XML diff (структурный) |
|---|---|---|
| Единица сравнена | Строки текста | Узлы в дереве |
| Повторное отступление | Показывает как изменения | Игнорируется |
| Переупорядочение атрибутов | Показывает как изменение | Игнорируется |
| Отчеты меняют местоположение | Номер строки | Путь узла, например/каталог/книга[2]/@id |
| Отличает элемент от атрибута против текста | нет | да |
| лучше для | Исходный код, проза | Конфигурация XML, полезные данные API, SVG, карты сайта |
Конкретный пример делает наслоение ясным Возьмите небольшой книжный каталог, где между двумя версиями одна книга's категория атрибут изменения от художественной литературы к тайне, тот самый книга's цена текста меняется с 12.99 до 14.99, и вторая книга получает новый isbn элемент. строка diff будет помечать все три плюс любые повторные отступы вокруг них, перемешаны вместе. структурный diff сообщает ровно три различия: измененный атрибут на пути категории, измененный текстовый узел на пути цены, и добавленный элемент на пути isbn. Каждый помечен своим видом, так что вы можете сказать с первого взгляда, что два были правками существующих данных и один был подлинным дополнением. что разделение является разницей между чтением отчета и расшифровкой одного.
Инструмент также группирует результаты в добавленные, удаленные и измененные вкладки с текущим подсчетом, поэтому вы можете сначала ответить на грубые вопросы, такие как & quot;did anything get deleted, & quot; перед изучением специфики. В большом документе этот порядок имеет значение: удаление часто является наиболее опасным изменением, потому что упавший элемент может молча удалить необходимое поле, а возможность изолировать его, не перебирая несвязанные изменения, является экономией реального времени.
Что означает путь узла в разнице?
Каждое различие помечено путем, который точно сообщает вам, где в дереве он находится, поэтому вы можете перейти к нему вместо сканирования файла. Путь построен из имен элементов, соединенных косыми чертами от корня вниз. Когда у элемента есть одноимённые братья и сестры, индекс на основе одного в скобках размыкает, какой из них, так что /catalog/book[2] является второй книгой. атрибут пишется с помощью @ префикс, как в /catalog/book[1]/@category, и изменение текста отмечено значком text(), как в /catalog/book[2]/price/text(), йо-
Эта запись намеренно близка к XPath, язык W3C для адресации узлов в XML документе, поэтому, если вы уже читали XPath пути будут чувствовать себя знакомыми и вы часто можете вставить аналогичное выражение в свой собственный инструмент для выбора того же узла. даже не зная XPath, пути читаются естественным образом: имена спускаются по дереву, скобки выбирают брата или сестру, @ является атрибутом, и text() является содержанием.
Поскольку путь называет вид изменения тоже, отчет отвечает сразу на три вопроса: что изменилось, где он живет, и был ли это элемент, атрибут или текст, Это обычно достаточно, чтобы открыть правильный файл и исправить правильную линию без какой-либо дальнейшей охоты.
Когда бы я действительно использовал это?
Дрейф конфигурации - это случай, в который я попал больше всего Когда служба ведет себя по-разному между двумя средами и единственным подозреваемым является конфигурация XML, сравнение двух файлов структурно сообщает вам за считанные секунды, действительно ли значение изменилось или кто-то только что переформатировал файл. то же самое относится к построению и развертыванию конвейеров, которые переписывают XML, где вам нужно подтвердить преобразование изменило только то, что оно должно было.
API и работа по интеграции - следующий. Ответы SOAP, каналы RSS и Atom, а также старые API REST по-прежнему говорят на XML, и когда полезная нагрузка перестает правильно анализировать структурный разрыв на известную хорошую выборку быстро определяет вызывающий нарушение элемент. SVG также является XML, поэтому сравнение двух экспортированных значков показывает, какой именно путь или атрибут был изменен редактором. Карты сайта, файлы макета Android, POM Maven и .docx внутренние все XML под капотом, и все извлекают выгоду из одного и того же лечения. Я строю через стек, и XML появляется в большем количестве углов, чем ожидают люди, поэтому это живет рядом с XML-форматтер а XML в JSON в своих закладках. я набросал, как они подходят более широкому набору в Руководство JSON по XML, йо-
Есть угол обзора кода также, Когда запрос на извлечение касается XML-привязки или сгенерированного файла, необработанный разница в пользовательском интерфейсе обзора часто нечитаемый, потому что форматировщик переписал все это. Запуск до и после через структурное сравнение, затем вставка короткого отчета в обзор, сообщает вашему рецензенту, что на самом деле изменилось за один взгляд, вместо того, чтобы просить его доверять стене красного цвета. Инструмент и #39;s копируемый текстовый отчет существует именно для этого: компактное резюме каждого добавленного, удаленного и измененного узла с его значениями до и после, готовый упасть в билет, сообщение фиксации или поток чата.
Соседние инструменты сравнения охватывают случаи, когда XML diff не охватывает. Когда ваши данные табличные, Разница CSV сравнивает строки и ячейки, а для двух простых списков Список Сравнить инструмент действительно устанавливает различия. Они разделяют одну и ту же философию: сначала проанализируйте данные в их естественную форму, затем сравните, чтобы разница отражала смысл, а не макет.
Каковы ограничения и является ли мой XML частным?
Инструмент сравнивает структуру, что означает, что он намеренно не сообщает виды различий, которые структура не захватывает. упорядочение двух атрибутов, изменение отступов или замена самозакрывающегося синтаксиса - все это рассматривается как отсутствие изменений, по дизайну. если ваш вариант использования действительно нуждается в точном сравнении байтов, текстовый разност является правильным инструментом, а это не так. Структурный разност также объединяет повторяющиеся элементы по позициям, поэтому, если одни и те же записи перемещаются в другом порядке, инструмент видит перемещенные как измененные, а не перемещенные; сначала сортировка обоих документов стабильным ключом, когда это имеет смысл, дает самый чистый результат.
Неправильно сформированный XML сообщается, а не угадывается. если документ имеет несовпадающий или незакрытый тег или более одного корневого элемента, инструмент называет проблему и сообщает вам, с какой стороны он пришел, поэтому вы никогда не получите вводящий в заблуждение дифференциал от сломанного ввода. Он обрабатывает общие конструкции реального мира, которые должен использовать анализатор: атрибуты в одиночных или двойных кавычках, самозакрывающиеся теги, разделы CDATA, комментарии, инструкции по обработке и стандартные ссылки на объекты, такие как < а &, йо-
В конфиденциальности все работает в вашем браузере. оба документа анализируются и сравниваются локально, и ничего не загружается, не регистрируется и не сохраняется. Это свойство, которое делает безопасным распространение производственной конфигурации, внутренней полезной нагрузки API или файла, специфичного для клиента, ни один из которых не принадлежит на сервере stranger's. The Конфиденциальность данных в онлайн-инстру руководство объясняет, как проверить, что инструмент действительно находится на стороне клиента, что стоит сделать, прежде чем вставлять что-либо конфиденциальное в любой веб-инструмент.
Часто задаваемые вопросы
Как сравнить два XML-файла?
Вставьте исходный XML в первое поле, а измененный XML во второе, затем нажмите "Сравнить". Инструмент анализирует деревья узлов и перечисляет каждое добавленное, удаленное и измененное значение элемента, атрибута и текста, каждое из которых закреплено на пути к узлу. Ничего не загружается.
Чем XML-дифф отличается от обычного текстового диффа?
Текстовый разностный анализ сравнивает файлы построчно, поэтому повторное отступление, изменение порядка атрибутов или повторная упаковка строк делает почти все выглядеть измененным. XML-разница сначала анализирует оба документа на деревья и сравнивает их структурно, поэтому сообщает только о различиях, которые изменят способ чтения документа синтаксическим анализатором.
Считает ли переупорядочение атрибутов изменением?
Нет. Атрибуты сравниваются по имени независимо от порядка их появления в теге, поскольку порядок атрибутов не имеет значения в XML. Сообщается только об измененном значении, добавленном атрибуте или удаленном атрибуте.
Как повторяющиеся элементы сопоставляются между двумя документами?
Дочерние элементы, имеющие общее имя тега, парятся по порядку их появления, поэтому первый элемент сравнивается с первым элементом, второй - со вторым и т. д. Если в одном документе встречается больше, чем в другом, дополнительные элементы сообщаются как добавленные или удаленные.
Что означает путь узла в каждой разнице?
Путь показывает, где в дереве изменение, используя имена элементов, один-основанный индекс в скобках, когда есть одноимённые братья и сестры, @name для атрибута и текст () для текстового контента Например, /catalog/book [2]/@id указывает на атрибут id второй книги.
Влияет ли пробелы или форматирование на сравнение?
По умолчанию текст, доступный только для пробелов, игнорируется, а пробелы пробелов внутри текста сворачиваются, поэтому переформатирование документа не создает ложных различий. Вы можете полагаться на структурное сравнение, а не точно сопоставлять отступы.
Что произойдет, если XML будет искажен?
Инструмент сообщает о явной ошибке с указанием проблемы, например, о несоответствии или незакрытии тега, и сообщает вам, из какого документа он был получен. Он не угадывает при ремонте, поэтому вы никогда не получите вводящего в заблуждение различия от сломанного ввода.
Мои XML-документы загружены куда-нибудь?
Нет. Все анализы и сравнения происходят как JavaScript в вашем браузере. Ничего не передается, не регистрируется и не сохраняется. Вы можете подтвердить это, просмотрев вкладку сети или отключившись от Интернета, инструмент продолжает работать в автономном режиме.
Сравните свои документы с бесплатными Проверка различий XML. Он сообщает о структурных различиях по путям узлов, полностью в вашем браузере, без загрузки.
