ПараметрыЗаписиXML.По умолчанию

Настроить читаемый XML и проверить обратное чтение

UTF-8, версия 1.0, отступы элементов и атрибутов, два пробела. После записи снова читаем свой XML и сравниваем данные.

Подготовка

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

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

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

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

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

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

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

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

1. Создать параметры по умолчанию и отдельные параметры с пятью аргументами в правильном порядке. Свойства параметров только читаются.

2. Передать параметры в УстановитьСтроку и проверить фактические Запись.Параметры.

3. Объявление XML записать до корня. Атрибут A&B и текст с < и & передать штатным методам: их экранирование делает ЗаписьXML.

4. Закрыть возвращает строку. Полностью прочитать её и сравнить код, количество и текст, не полагаясь только на внешний вид.

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

1. Девять булевых проверок дают Истина.

2. XML выводится для чтения. Кодировка в объявлении строки — метка; настоящие UTF-8 байты показаны в уроке потока.

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

Готовая запись и обратное чтение собственного товара с понятными настройками оформления.

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

1. Нельзя присвоить Параметры.Отступ: создайте новый объект параметров.

2. СимволыОтступа могут содержать только пробельные символы.

3. Не сравнивайте весь XML побайтно из-за отступов: данные проверяются читателем.

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