ЗаписьXML.ЗаписатьБезОбработки

Вставить свой готовый фрагмент в общий XML

Вставляем не внешний текст, а фрагмент, который только что корректно создал второй ЗаписьXML на собственных данных.

Подготовка

1. В своей учебной базе 8.5.1.1343 создайте серверный общий модуль УчебнаяЗаписьXML. Вставьте полный модуль одного урока и вызовите УчебнаяЗаписьXML.ВыполнитьПример() из собственной серверной команды.

2. Все тексты и товары заданы константами: Книга, A&B, количество 3. Учётные данные, файлы организации, HTTP и внешние XML не используются.

3. Первые шесть уроков работают только со строками/потоком в памяти. Последний создаёт один новый временный XML в собственной учебной базе; имя выводится, файл оставляется для ручной проверки.

4. Для урока файла имя конфигурации должно быть УчебнаяКонфигурацияСинтаксиса. Существующий файл не перезаписывается. После проверки удалите вручную только показанный собственный временный файл.

5. ПараметрыЗаписиXML неизменяемы после создания. Все пять параметров задаются конструктором, а не присваиванием свойств.

Процедура ВыполнитьПример() Экспорт
    Фрагмент = Новый ЗаписьXML;
    Фрагмент.УстановитьСтроку();
    Попытка
        Фрагмент.ЗаписатьНачалоЭлемента("product");
        Фрагмент.ЗаписатьАтрибут("code", "A&B");
        Фрагмент.ЗаписатьАтрибут("quantity", "3");
        Фрагмент.ЗаписатьТекст("Книга <учебник> & пособие");
        Фрагмент.ЗаписатьКонецЭлемента();
        СобственныйФрагмент = Фрагмент.Закрыть();
    Исключение
        Фрагмент.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
    Запись = Новый ЗаписьXML;
    Запись.УстановитьСтроку();
    Попытка
        Запись.ЗаписатьНачалоЭлемента("catalog");
        Запись.ЗаписатьБезОбработки(СобственныйФрагмент);
        Запись.ЗаписатьКонецЭлемента();
        XML = Запись.Закрыть();
    Исключение
        Запись.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
    Товар = ПрочитатьУчебныйТовар(XML);
    Сообщить(Товар.Корень = "catalog");
    Сообщить(Товар.Код = "A&B");
    Сообщить(Товар.Количество = "3");
    Сообщить(Товар.Текст = "Книга <учебник> & пособие");
КонецПроцедуры

Функция ПрочитатьУчебныйТовар(XML)
    Чтение = Новый ЧтениеXML;
    Результат = Новый Структура("Корень,Код,Количество,Текст", "", "", "", "");
    ВТоваре = Ложь;
    Попытка
        Чтение.УстановитьСтроку(XML);
        Пока Чтение.Прочитать() Цикл
            Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента Тогда
                Если ПустаяСтрока(Результат.Корень) Тогда
                    Результат.Корень = Чтение.ЛокальноеИмя;
                КонецЕсли;
                Если Чтение.ЛокальноеИмя = "product" Тогда
                    ВТоваре = Истина;
                    Результат.Код = Чтение.ПолучитьАтрибут("code");
                    Результат.Количество = Чтение.ПолучитьАтрибут("quantity");
                КонецЕсли;
            ИначеЕсли ВТоваре И (Чтение.ТипУзла = ТипУзлаXML.Текст
                ИЛИ Чтение.ТипУзла = ТипУзлаXML.СекцияCDATA) Тогда
                Результат.Текст = Результат.Текст + Чтение.Значение;
            ИначеЕсли Чтение.ТипУзла = ТипУзлаXML.КонецЭлемента
                И Чтение.ЛокальноеИмя = "product" Тогда
                ВТоваре = Ложь;
            КонецЕсли;
        КонецЦикла;
    Исключение
        Чтение.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
    Чтение.Закрыть();
    Возврат Результат;
КонецФункции

Разбор по шагам

1. Первым писателем создать один product без объявления XML. Атрибут и текст передать штатным экранирующим методам.

2. Закрыть первый писатель и получить готовый СобственныйФрагмент.

3. Вторым писателем открыть catalog и вставить фрагмент через ЗаписатьБезОбработки.

4. Завершить общий документ, полностью прочитать и сравнить четыре поля. Это проверяет структуру после вставки.

Как проверить результат

1. Четыре проверки дают Истина.

2. В catalog ровно один учебный product с кодом A&B, количеством 3 и исходным текстом.

Ожидаемый результат

Практический рецепт сборки собственного XML из уже корректных фрагментов.

На что обратить внимание

1. ЗаписатьБезОбработки не экранирует, не проверяет и не обезвреживает чужой ввод.

2. Фрагмент не должен содержать второе объявление XML или DOCTYPE.

3. При внешних данных разбирайте и проверяйте разрешённые узлы либо используйте ЗаписатьТекст.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.