Предоставляет возможность определения идентичности (ссылаются на один и тот же объект) двух узлов.
Синтаксис
УзелИдентичен(<Узел>)Полное описание, параметры и ограничения
ОпределениеТипаДокументаDOM.УзелИдентичен (DOMDocumentType.IsSameNode)
ОпределениеТипаДокументаDOM (DOMDocumentType)
УзелИдентичен (IsSameNode)
Доступен, начиная с версии 8.1.
Синтаксис:
УзелИдентичен(<Узел>)
Параметры:
<Узел> (обязательный)
Тип: АтрибутDOM, ДокументDOM, ЭлементDOM, ОпределениеТипаДокументаDOM, НотацияDOM, СущностьDOM, ФрагментДокументаDOM, ТекстDOM, КомментарийDOM, СекцияCDATADOM, ИнструкцияОбработкиDOM, СсылкаНаСущностьDOM, ПространствоИменXPath.
Узел DOM, с которым производится сравнение.
Возвращаемое значение:
Тип: Булево.
Описание:
Предоставляет возможность определения идентичности (ссылаются на один и тот же объект) двух узлов.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Клонировать ссылку и DOCTYPE, но не namespace XPath
Клон — другой объект. Копирование неопределённой ссылки не создаёт её объявления. Для namespace справка прямо запрещает КлонироватьУзел.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
DOCTYPE создан собственным конструктором с пустыми PUBLIC/SYSTEM. Внутренних сущностей/нотаций нет; guideProduct — намеренно неопределённая ссылка, а не загруженный товар.
Этот документ исследуется только в памяти. Не сохраняйте и не передавайте его как готовый XML обмена: ссылка guideProduct не объявлена.
XPath namespace::g возвращает специализированный узел, а не строку URI и не обычный атрибут xmlns.
ОписаниеТипа = Новый ОпределениеТипаДокументаDOM("products", "", "");
Документ = Новый ДокументDOM("urn:guide:special", "g:products", ОписаниеТипа);
Корень = Документ.ЭлементДокумента;
Корень.УстановитьСоответствиеПространстваИмен("g", "urn:guide:special");
Ссылка = Документ.СоздатьСсылкуНаСущность("guideProduct");
Корень.ДобавитьДочерний(Ссылка);
Разыменователь = Документ.СоздатьРазыменовательПИ();
Результат = Документ.ВычислитьВыражениеXPath("namespace::g", Корень,
Разыменователь, ТипРезультатаDOMXPath.НеупорядоченныйСнимокУзлов);
Если Результат.РазмерСнимка <> 1 Тогда
ВызватьИсключение "Ожидался ровно один собственный namespace g";
КонецЕсли;
Пространство = Результат.ЭлементСнимка(0);
Если ТипЗнч(Пространство) <> Тип("ПространствоИменXPath") Тогда
ВызватьИсключение "Ожидался настоящий узел ПространствоИменXPath";
КонецЕсли;
Узлы = Новый Массив;
Узлы.Добавить(ОписаниеТипа);
Узлы.Добавить(Ссылка);
Узлы.Добавить(Пространство);
КопияТипа = ОписаниеТипа.КлонироватьУзел(Истина);
КопияСсылки = Ссылка.КлонироватьУзел(Истина);
Сообщить(ОписаниеТипа.УзелРавен(КопияТипа));
Сообщить(Не ОписаниеТипа.УзелИдентичен(КопияТипа));
Сообщить(Ссылка.УзелРавен(КопияСсылки));
Сообщить(Не Ссылка.УзелИдентичен(КопияСсылки));
Сообщить(КопияСсылки.ДочерниеУзлы.Количество() = 0);
Отказ = Ложь;
Попытка
КопияПИ = Пространство.КлонироватьУзел(Истина);
Сообщить(ТипЗнч(КопияПИ));
Исключение
Отказ = Истина;
Сообщить("Ожидаемый запрет копирования namespace: " + ОписаниеОшибки());
КонецПопытки;
Сообщить(Отказ);
Сообщить(Пространство.УзелИдентичен(Пространство));
Сообщить(Пространство.УзелРавен(Пространство));Разбор по шагам
Глубокое копирование у пустых DOCTYPE/ссылки не добавляет неизвестное содержимое.
УзелРавен сравнивает содержимое, УзелИдентичен — один ли это объект. Клон равен, но не идентичен.
Копирование namespace помещаем в отдельную отрицательную проверку; контроль Отказ расположен вне перехвата.
Как проверить результат
Пять первых сравнений дают Истина; исходные узлы остаются в дереве.
Для namespace Отказ = Истина; сам узел равен/идентичен самому себе, но это не разрешает его копирование.
Ожидаемый результат
Разобраны разница копии и идентичности и запрет клонирования namespace.
На что обратить внимание
Не считайте пойманную ошибку копирования успешным клонированием.
Копирование DOM не выполняет импорт товаров или бизнес-запись.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Сравнить положение специальных узлов, не считать его равенством
СравнитьПозициюВДокументе отвечает о расположении относительно другого узла. Для namespace точный порядок не обещаем: выводим фактическое значение отдельно от идентичности.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
DOCTYPE создан собственным конструктором с пустыми PUBLIC/SYSTEM. Внутренних сущностей/нотаций нет; guideProduct — намеренно неопределённая ссылка, а не загруженный товар.
Этот документ исследуется только в памяти. Не сохраняйте и не передавайте его как готовый XML обмена: ссылка guideProduct не объявлена.
XPath namespace::g возвращает специализированный узел, а не строку URI и не обычный атрибут xmlns.
ОписаниеТипа = Новый ОпределениеТипаДокументаDOM("products", "", "");
Документ = Новый ДокументDOM("urn:guide:special", "g:products", ОписаниеТипа);
Корень = Документ.ЭлементДокумента;
Корень.УстановитьСоответствиеПространстваИмен("g", "urn:guide:special");
Ссылка = Документ.СоздатьСсылкуНаСущность("guideProduct");
Корень.ДобавитьДочерний(Ссылка);
Разыменователь = Документ.СоздатьРазыменовательПИ();
Результат = Документ.ВычислитьВыражениеXPath("namespace::g", Корень,
Разыменователь, ТипРезультатаDOMXPath.НеупорядоченныйСнимокУзлов);
Если Результат.РазмерСнимка <> 1 Тогда
ВызватьИсключение "Ожидался ровно один собственный namespace g";
КонецЕсли;
Пространство = Результат.ЭлементСнимка(0);
Если ТипЗнч(Пространство) <> Тип("ПространствоИменXPath") Тогда
ВызватьИсключение "Ожидался настоящий узел ПространствоИменXPath";
КонецЕсли;
Узлы = Новый Массив;
Узлы.Добавить(ОписаниеТипа);
Узлы.Добавить(Ссылка);
Узлы.Добавить(Пространство);
Для Каждого Узел Из Узлы Цикл
Сообщить(Узел.ТипУзла);
Сообщить(Узел.СравнитьПозициюВДокументе(Корень));
Сообщить(Не Узел.УзелИдентичен(Корень));
Сообщить(Не Узел.УзелРавен(Корень));
КонецЦикла;
Сообщить(ОписаниеТипа.РодительскийУзел = Документ);
Сообщить(Ссылка.РодительскийУзел = Корень);Разбор по шагам
У трёх специальных узлов разные роли и разные связи с корнем.
Позицию выводим как значение платформы, не превращаем в индекс массива или число строк товара.
Равенство и идентичность проверяем отдельными вызовами; положение не заменяет эти сравнения.
Как проверить результат
По два сравнения в трёх итерациях дают Истина: ни один специальный узел не является корнем и не равен ему.
Два последних сравнения Истина, конкретное значение позиции namespace фиксируется диагностически.
Ожидаемый результат
Разделены положение в документе, равенство содержания и идентичность объектов.
На что обратить внимание
Не сортируйте товарные строки по диагностическому порядку объявлений namespace.
Для разных/отсоединённых деревьев позиция может иметь другое значение и зависеть от реализации.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.