Осуществляет проверку двух узлов на равенство (не на идентичность). Два узла DOM равны, если: узлы являются узлами одного типа; значения следующих свойств узла равны: (ИмяУзла, ЛокальноеИмя, URIПространстваИмен, Префикс, ЗначениеУзла) (или оба не определены или оба равны); коллекции атрибутов узлов равны: или обе не определены, или имеют одинаковый размер и одинаковое значение для одинаковых ключей (необязательно при этом с одинаковыми индексами); списки дочерних узлов равны: или оба списка пустые, или оба имеют одинаковую длину и содержат равные узлы по одинаковым индексам. Нормализация влияет на равенство. Чтобы избежать ошибок сравнения, рекомендуется нормализовать узлы перед сравнением. Два узла ОпределениеТипаДокумента равны, если выполняются все вышеперечисленные условия, а также: значения следующих свойств равны: ПубличныйИдентификатор, СистемныйИдентификатор, ВнутреннееПодмножество; коллекции определений сущностей равны; коллекции нотаций равны. На равенство не оказывают влияние: свойства ДокументВладелец, БазовыйURI и РодительУзла; свойство Указан для узлов Атрибут; свойство ЭтоПробельныеСимволыЭлемента для узлов Текст; пользовательские данные. Замечание. Все, что не указано как влияющее на равенство, на него не влияет.
Синтаксис
УзелРавен(<Узел>)Полное описание, параметры и ограничения
ДокументDOM.УзелРавен (DOMDocument.IsEqualNode)
ДокументDOM (DOMDocument)
УзелРавен (IsEqualNode)
Доступен, начиная с версии 8.1.
Синтаксис:
УзелРавен(<Узел>)
Параметры:
<Узел> (обязательный)
Тип: АтрибутDOM, ДокументDOM, ЭлементDOM, ОпределениеТипаДокументаDOM, НотацияDOM, СущностьDOM, ФрагментДокументаDOM, ТекстDOM, КомментарийDOM, СекцияCDATADOM, ИнструкцияОбработкиDOM, СсылкаНаСущностьDOM, ПространствоИменXPath.
Сравниваемый узел DOM.
Возвращаемое значение:
Тип: Булево.
Описание:
Осуществляет проверку двух узлов на равенство (не на идентичность).
Два узла DOM равны, если:
узлы являются узлами одного типа;
значения следующих свойств узла равны: (ИмяУзла, ЛокальноеИмя, URIПространстваИмен, Префикс, ЗначениеУзла) (или оба не определены или оба равны);
коллекции атрибутов узлов равны: или обе не определены, или имеют одинаковый размер и одинаковое значение для одинаковых ключей (необязательно при этом с одинаковыми индексами);
списки дочерних узлов равны: или оба списка пустые, или оба имеют одинаковую длину и содержат равные узлы по одинаковым индексам.
Нормализация влияет на равенство. Чтобы избежать ошибок сравнения, рекомендуется нормализовать узлы перед сравнением.
Два узла ОпределениеТипаДокумента равны, если выполняются все вышеперечисленные условия, а также:
значения следующих свойств равны: ПубличныйИдентификатор, СистемныйИдентификатор, ВнутреннееПодмножество;
коллекции определений сущностей равны;
коллекции нотаций равны.
На равенство не оказывают влияние:
свойства ДокументВладелец, БазовыйURI и РодительУзла;
свойство Указан для узлов Атрибут;
свойство ЭтоПробельныеСимволыЭлемента для узлов Текст;
пользовательские данные.
Замечание. Все, что не указано как влияющее на равенство, на него не влияет.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Клонировать весь XML-документ и сравнить структуру, а не ссылки
Полная копия документа — отдельный документ-владелец. XML-структура равна исходной, но идентичность и локальные служебные метки различаются.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
Преобразования выполняются только над собственным XML в памяти. Примеры не читают файлы, внешние DTD, URL или данные информационной базы.
У методов DOM возвращаемый узел сохраняйте в переменную: исходная ссылка и результат операции не всегда обозначают один объект.
Документ = Новый ДокументDOM("", "products");
Товар = Документ.СоздатьЭлемент("product");
Товар.УстановитьАтрибут("code", "A-01");
Товар.ДобавитьДочерний(Документ.СоздатьТекстовыйУзел("Книга"));
Документ.ЭлементДокумента.ДобавитьДочерний(Товар);
Документ.УстановитьПользовательскиеДанные("training-tag", "original-document");
Сообщить(Документ.ПолучитьПользовательскиеДанные("training-tag") = "original-document");
Копия = Документ.КлонироватьУзел(Истина);
Сообщить(ТипЗнч(Копия) = Тип("ДокументDOM"));
Сообщить(Документ.УзелРавен(Копия));
Сообщить(Не Документ.УзелИдентичен(Копия));
Сообщить(Копия.ПолучитьПользовательскиеДанные("training-tag") = Неопределено);
КопияТовара = Копия.ЭлементДокумента.ПервыйДочерний;
Сообщить(КопияТовара.ДокументВладелец = Копия);
Сообщить(Товар.ДокументВладелец = Документ);
КопияТовара.УстановитьАтрибут("code", "COPY");
Сообщить(Товар.ПолучитьАтрибут("code") = "A-01");
Сообщить(Не Документ.УзелРавен(Копия));Разбор по шагам
Строим исходный документ целиком: products/product с атрибутом и текстовым ребёнком.
УстановитьПользовательскиеДанные записывает локальную метку документа, не XML-атрибут.
КлонироватьУзел(Истина) копирует весь документ. УзелРавен сравнивает структуру и значения, УзелИдентичен — тот же ли это узел.
У копии свои дети с владельцем Копия. Меняем code только там, после чего документы уже не равны; исходник сохраняет A-01.
Как проверить результат
Девять логических проверок дают Истина.
До изменения копии документы равны по структуре, но не идентичны. После изменения code копии они не равны.
У копии нет training-tag; XML-данные исходника не изменены.
Ожидаемый результат
Получена независимая полная копия собственного XML для безопасного преобразования.
На что обратить внимание
КлонироватьУзел элемента и всего документа — разные операции: копия отдельного элемента первоначально сохраняет исходный документ-владелец.
Не используйте УзелРавен как проверку подписи, бизнес-валидности или безопасности XML.
Служебные данные не являются частью переносимого XML-контракта и не клонируются автоматически.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.