Предоставляет возможность определения идентичности (ссылаются на один и тот же объект) двух узлов.
Синтаксис
УзелИдентичен(<Узел>)Полное описание, параметры и ограничения
АтрибутDOM.УзелИдентичен (DOMAttribute.IsSameNode)
АтрибутDOM (DOMAttribute)
УзелИдентичен (IsSameNode)
Доступен, начиная с версии 8.1.
Синтаксис:
УзелИдентичен(<Узел>)
Параметры:
<Узел> (обязательный)
Тип: АтрибутDOM, ДокументDOM, ЭлементDOM, ОпределениеТипаДокументаDOM, НотацияDOM, СущностьDOM, ФрагментДокументаDOM, ТекстDOM, КомментарийDOM, СекцияCDATADOM, ИнструкцияОбработкиDOM, СсылкаНаСущностьDOM, ПространствоИменXPath.
Узел DOM, с которым производится сравнение.
Возвращаемое значение:
Тип: Булево.
Описание:
Предоставляет возможность определения идентичности (ссылаются на один и тот же объект) двух узлов.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Назначить товару XML-идентификатор и работать с узлом атрибута
Атрибут id становится идентификатором только после явной отметки. Остальные атрибуты читаем и удаляем через элемент и коллекцию.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Серверный контекст. Все узлы принадлежат одному документу.
Идентификатор A-01 уникален в пределах учебного документа.
Документ = Новый ДокументDOM("", "products");
Товар = Документ.СоздатьЭлемент("product");
Документ.ЭлементДокумента.ДобавитьДочерний(Товар);
Атрибут = Документ.СоздатьАтрибут("id");
Атрибут.Значение = "A-01";
Товар.УстановитьУзелАтрибута(Атрибут);
Товар.УстановитьАтрибутИдентификатор("id", Истина);
Сообщить(Атрибут.Имя);
Сообщить(Атрибут.Значение);
Сообщить(Атрибут.ЯвляетсяИдентификатором);
Сообщить(Атрибут.Указан);
Сообщить(Атрибут.ЭлементВладелец = Товар);
Сообщить(Документ.ПолучитьЭлементПоИдентификатору("A-01").УзелИдентичен(Товар));
Сообщить(Товар.ЕстьАтрибут("id"));
Сообщить(Товар.ПолучитьАтрибут("id"));
Сообщить(Товар.ПолучитьУзелАтрибута("id").УзелИдентичен(Атрибут));
Товар.УстановитьАтрибут("quantity", "3");
Атрибуты = Товар.Атрибуты;
Сообщить(Атрибуты.Количество());
Для Номер = 0 По Атрибуты.Количество() - 1 Цикл
Текущий = Атрибуты.Элемент(Номер);
Сообщить(Текущий.Имя + "=" + Текущий.Значение);
КонецЦикла;
Сообщить(Атрибуты.ПолучитьИменованныйЭлемент("quantity").Значение);
Товар.УдалитьАтрибут("quantity");
Временный = Документ.СоздатьАтрибут("temporary");
Временный.Значение = "yes";
Атрибуты.УстановитьИменованныйЭлемент(Временный);
Атрибуты.УдалитьИменованныйЭлемент("temporary");
Сообщить(Атрибуты.Количество());Разбор по шагам
Создаём атрибут фабрикой документа, задаём значение и присоединяем к товару.
УстановитьАтрибутИдентификатор отмечает id; после этого документ может найти товар по его значению.
ПолучитьАтрибут возвращает строку, ПолучитьУзелАтрибута — объект атрибута.
Обходим коллекцию без предположения о порядке; удаляем quantity и временный атрибут.
Как проверить результат
Найденный по A-01 элемент идентичен товару; атрибут принадлежит товару и имеет признак идентификатора.
Перед удалением есть 2 атрибута, после всей последовательности остаётся только id: количество 1.
Ожидаемый результат
Товар имеет настоящий DOM-идентификатор, работа с атрибутом и его строковым значением различена.
На что обратить внимание
Имя id само по себе не гарантирует статус идентификатора: нужна отметка или соответствующее объявление схемы.
Порядок атрибутов XML незначим; не полагайтесь на то, что id имеет индекс 0.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Найти пространство имён от текста, атрибута и отсоединённого фрагмента
Поиск namespace учитывает положение узла, а не только его ДокументВладелец. Восемь видов узлов показывают наследование от корня и отсутствие такого контекста у отдельного фрагмента.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
Документ = Новый ДокументDOM("urn:guide:nodes", "g:guide");
Корень = Документ.ЭлементДокумента;
Корень.УстановитьСоответствиеПространстваИмен("g", "urn:guide:nodes");
Атрибут = Документ.СоздатьАтрибут("code");
Атрибут.Значение = "A-01";
Корень.УстановитьУзелАтрибута(Атрибут);
Текст = Документ.СоздатьТекстовыйУзел("Книга");
Комментарий = Документ.СоздатьКомментарий("учебный комментарий");
CDATA = Документ.СоздатьСекциюCDATA("<данные>");
Инструкция = Документ.СоздатьИнструкциюОбработки("guide", "mode=test");
Корень.ДобавитьДочерний(Текст);
Корень.ДобавитьДочерний(Комментарий);
Корень.ДобавитьДочерний(CDATA);
Корень.ДобавитьДочерний(Инструкция);
Фрагмент = Документ.СоздатьФрагментДокумента();
Фрагмент.ДобавитьДочерний(Документ.СоздатьЭлемент("note"));
Узлы = Новый Массив;
Узлы.Добавить(Документ);
Узлы.Добавить(Корень);
Узлы.Добавить(Атрибут);
Узлы.Добавить(Текст);
Узлы.Добавить(Комментарий);
Узлы.Добавить(CDATA);
Узлы.Добавить(Инструкция);
Узлы.Добавить(Фрагмент);
URI = "urn:guide:nodes";
Корень.УстановитьСоответствиеПространстваИмен("", URI);
Для Каждого Узел Из Узлы Цикл
НайденныйURI = Узел.НайтиURIПространстваИмен("g");
НайденныйПрефикс = Узел.НайтиПрефикс(URI);
ЭтоПоУмолчанию = Узел.ПространствоИменПоУмолчанию(URI);
Сообщить(СтрШаблон("%1 / %2: g → %3, префикс URI → %4", ТипЗнч(Узел), Узел.ИмяУзла,
Строка(НайденныйURI), Строка(НайденныйПрефикс)));
Если Узел.УзелИдентичен(Фрагмент) Тогда
Сообщить(НайденныйURI = Неопределено);
Сообщить(Не ЭтоПоУмолчанию);
Иначе
Сообщить(НайденныйURI = URI);
Сообщить(НайденныйПрефикс = "g");
Сообщить(ЭтоПоУмолчанию);
КонецЕсли;
КонецЦикла;
Сообщить(Фрагмент.ДокументВладелец = Документ);
Сообщить(Фрагмент.РодительскийУзел = Неопределено);Разбор по шагам
Корень g:guide объявляет g и пространство по умолчанию с одним URI. Текст, комментарий, CDATA и инструкция являются его детьми; атрибут принадлежит корню через ЭлементВладелец.
НайтиURIПространстваИмен ищет соответствие от данного узла. Для документа используется корневой элемент, для атрибута — его элемент-владелец, для прикреплённых листьев — родитель.
НайтиПрефикс ищет именно именованный префикс g; пустой префикс по умолчанию не заменяет его. ПространствоИменПоУмолчанию отдельно проверяет URI.
Фрагмент не присоединён к корню. Наличие того же ДокументВладелец не заставляет его наследовать объявления корня.
Как проверить результат
Для первых семи видов проверки URI, g и пространства по умолчанию дают Истина.
Для отсоединённого фрагмента URI по g не найден, проверка пространства по умолчанию ложная; две проверки этой ветки дают Истина.
В конце подтверждаются общий документ-владелец фрагмента и отсутствие родителя.
Ожидаемый результат
На конкретном дереве разобраны контекст поиска namespace у разных видов DOM-узлов.
На что обратить внимание
URIПространстваИмен самого текстового/комментарного узла не равен результату поиска объявленного URI от его родителя.
После перемещения узла к другому родителю результат поиска может измениться. Не храните соответствие как неизменный глобальный справочник.
Присвоение объявления namespace не переименовывает уже созданные элементы и атрибуты; их собственные имена/URI задаются отдельно.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.