Выполняет чтение узла (узлов) в контексте документа DOM.
Синтаксис
ПрочитатьВКонтексте(<ИсточникДанныхXML>, <УзелКонтекстаDOM>, <Действие>)Полное описание, параметры и ограничения
ПостроительDOM.ПрочитатьВКонтексте (DOMBuilder.ReadWithContext)
ПостроительDOM (DOMBuilder)
ПрочитатьВКонтексте (ReadWithContext)
Доступен, начиная с версии 8.1.
Синтаксис:
ПрочитатьВКонтексте(<ИсточникДанныхXML>, <УзелКонтекстаDOM>, <Действие>)
Параметры:
<ИсточникДанныхXML> (обязательный)
Тип: ЧтениеУзловDOM, ЧтениеFastInfoset, ЧтениеXML.
Объект чтения данных XML.
<УзелКонтекстаDOM> (обязательный)
Тип: АтрибутDOM, ДокументDOM, ЭлементDOM, ОпределениеТипаДокументаDOM, НотацияDOM, СущностьDOM, ФрагментДокументаDOM, ТекстDOM, КомментарийDOM, СекцияCDATADOM, ИнструкцияОбработкиDOM, СсылкаНаСущностьDOM, ПространствоИменXPath.
Узел контекста DOM.
<Действие> (обязательный)
Тип: ДействиеПостроителяDOM.
Действия, выполняемые над считываемыми узлами.
Возвращаемое значение:
Тип: АтрибутDOM, ДокументDOM, ЭлементDOM, ОпределениеТипаДокументаDOM, НотацияDOM, СущностьDOM, ФрагментДокументаDOM, ТекстDOM, КомментарийDOM, СекцияCDATADOM, ИнструкцияОбработкиDOM, СсылкаНаСущностьDOM, ПространствоИменXPath.
Описание:
Выполняет чтение узла (узлов) в контексте документа DOM.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Добавить C-03 последним ребёнком XML-корня
Читаем один собственный элемент C-03 в существующее учебное дерево A-01/B-02. Это изменение XML в памяти, не импорт или удаление записей базы.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
Каждый урок запускайте отдельно: он заново создаёт два товара без пробельных текстовых узлов между ними.
Читается ровно один собственный product; DOCTYPE, внешние сущности и несколько корней не используются.
Документ = Новый ДокументDOM("", "products");
Корень = Документ.ЭлементДокумента;
Для Номер = 1 По 2 Цикл
Товар = Документ.СоздатьЭлемент("product");
Товар.УстановитьАтрибут("code", ?(Номер = 1, "A-01", "B-02"));
Товар.ДобавитьДочерний(Документ.СоздатьТекстовыйУзел(?(Номер = 1, "Книга", "Ручка")));
Корень.ДобавитьДочерний(Товар);
КонецЦикла;
ПервыйТовар = Корень.ПервыйДочерний;
ПоследнийТовар = Корень.ПоследнийДочерний;
Источник = Новый ЧтениеXML;
Построитель = Новый ПостроительDOM;
Попытка
Источник.УстановитьСтроку("<product code=""C-03"">Карандаш</product>");
Прочитанный = Построитель.ПрочитатьВКонтексте(Источник, Корень,
ДействиеПостроителяDOM.ДобавитьКакДочерние);
Источник.Закрыть();
Исключение
Источник.Закрыть();
ВызватьИсключение;
КонецПопытки;
Коды = Новый Массив;
Для Каждого Товар Из Корень.ДочерниеУзлы Цикл
Если Товар.ТипУзла <> ТипУзлаDOM.Элемент Тогда
ВызватьИсключение "В собственной подготовке ожидались только элементы product";
КонецЕсли;
Коды.Добавить(Товар.ПолучитьАтрибут("code"));
КонецЦикла;
Сообщить(СтрСоединить(Коды, ",") = "A-01,B-02,C-03");
Сообщить(Корень.ДочерниеУзлы.Количество() = 3);
Сообщить(Прочитанный.РодительскийУзел.УзелИдентичен(Корень));
Сообщить(Прочитанный.ДокументВладелец = Документ);
Сообщить(Прочитанный.ТекстовоеСодержимое = "Карандаш");
Сообщить(Корень.ИмяЭлемента = "products");Разбор по шагам
Сохраняем ссылки на первый и последний исходные элементы, чтобы указать точный контекст чтения.
ДобавитьКакДочерние использует Корень: исходные два ребёнка остаются, новый становится последним.
ЧтениеXML закрывается при успешном разборе и в обработчике ошибки; исключение не маскируется.
Собираем коды всех детей корня в их фактическом порядке. Возвращённый узел отдельно проверяем по родителю, владельцу и тексту.
Как проверить результат
Шесть финальных сравнений Истина; точный порядок кодов A-01,B-02,C-03, количество 3.
Корень остаётся products, C-03 содержит Карандаш, прочитанный узел принадлежит этому документу.
Ожидаемый результат
Действие ДобавитьКакДочерние отработано на полностью заданном примере; итоговая последовательность A-01,B-02,C-03.
На что обратить внимание
Это не разбор произвольного недоверенного XML: для внешнего входа отдельно нужны запрет DTD и ограничения размера/времени.
Узел контекста определяет действие: Заменить заменяет выбранный узел, ЗаменитьДочерние — его детей. Не подменяйте одно другим.
Ссылки на отсоединённые старые узлы могут остаться в переменных; отсутствие их в корне не означает удаления бизнес-объектов.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Прочитать C-03 после первого XML-товара
Читаем один собственный элемент C-03 в существующее учебное дерево A-01/B-02. Это изменение XML в памяти, не импорт или удаление записей базы.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Документы и все узлы создаются в памяти на сервере. Внешние XML, DTD, сетевые схемы и файлы не загружаются.
Сначала оставьте учебные имена и значения неизменёнными. После контрольного запуска меняйте по одному условию.
Каждый урок запускайте отдельно: он заново создаёт два товара без пробельных текстовых узлов между ними.
Читается ровно один собственный product; DOCTYPE, внешние сущности и несколько корней не используются.
Документ = Новый ДокументDOM("", "products");
Корень = Документ.ЭлементДокумента;
Для Номер = 1 По 2 Цикл
Товар = Документ.СоздатьЭлемент("product");
Товар.УстановитьАтрибут("code", ?(Номер = 1, "A-01", "B-02"));
Товар.ДобавитьДочерний(Документ.СоздатьТекстовыйУзел(?(Номер = 1, "Книга", "Ручка")));
Корень.ДобавитьДочерний(Товар);
КонецЦикла;
ПервыйТовар = Корень.ПервыйДочерний;
ПоследнийТовар = Корень.ПоследнийДочерний;
Источник = Новый ЧтениеXML;
Построитель = Новый ПостроительDOM;
Попытка
Источник.УстановитьСтроку("<product code=""C-03"">Карандаш</product>");
Прочитанный = Построитель.ПрочитатьВКонтексте(Источник, ПервыйТовар,
ДействиеПостроителяDOM.ВставитьПосле);
Источник.Закрыть();
Исключение
Источник.Закрыть();
ВызватьИсключение;
КонецПопытки;
Коды = Новый Массив;
Для Каждого Товар Из Корень.ДочерниеУзлы Цикл
Если Товар.ТипУзла <> ТипУзлаDOM.Элемент Тогда
ВызватьИсключение "В собственной подготовке ожидались только элементы product";
КонецЕсли;
Коды.Добавить(Товар.ПолучитьАтрибут("code"));
КонецЦикла;
Сообщить(СтрСоединить(Коды, ",") = "A-01,C-03,B-02");
Сообщить(Корень.ДочерниеУзлы.Количество() = 3);
Сообщить(Прочитанный.РодительскийУзел.УзелИдентичен(Корень));
Сообщить(Прочитанный.ДокументВладелец = Документ);
Сообщить(Прочитанный.ТекстовоеСодержимое = "Карандаш");
Сообщить(Корень.ИмяЭлемента = "products");Разбор по шагам
Сохраняем ссылки на первый и последний исходные элементы, чтобы указать точный контекст чтения.
ВставитьПосле использует ссылку на A-01: C-03 становится его следующим соседом, оба прежних товара остаются.
ЧтениеXML закрывается при успешном разборе и в обработчике ошибки; исключение не маскируется.
Собираем коды всех детей корня в их фактическом порядке. Возвращённый узел отдельно проверяем по родителю, владельцу и тексту.
Как проверить результат
Шесть финальных сравнений Истина; точный порядок кодов A-01,C-03,B-02, количество 3.
Корень остаётся products, C-03 содержит Карандаш, прочитанный узел принадлежит этому документу.
Ожидаемый результат
Действие ВставитьПосле отработано на полностью заданном примере; итоговая последовательность A-01,C-03,B-02.
На что обратить внимание
Это не разбор произвольного недоверенного XML: для внешнего входа отдельно нужны запрет DTD и ограничения размера/времени.
Узел контекста определяет действие: Заменить заменяет выбранный узел, ЗаменитьДочерние — его детей. Не подменяйте одно другим.
Ссылки на отсоединённые старые узлы могут остаться в переменных; отсутствие их в корне не означает удаления бизнес-объектов.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.