Предназначен для организации записи документов HTML.
Полное описание, параметры и ограничения
ЗаписьHTML (HTMLWriter)
ЗаписьHTML (HTMLWriter)
Доступен, начиная с версии 8.2.
Методы:
Закрыть (Close)
ОткрытьПоток (OpenStream)
ОткрытьФайл (OpenFile)
УстановитьСтроку (SetString)
Конструкторы:
По умолчанию
Описание:
Предназначен для организации записи документов HTML.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Выгрузить изменённый HTML в строку и прочитать её повторно
ЗаписьDOM пишет дерево в ЗаписьHTML; Закрыть возвращает результат строки. Ни сохранения файла, ни исполнения разметки в браузере нет.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте учебную базу платформы 8.5.1.1343 и серверную процедуру учебного общего модуля. Каждый пример выполняйте отдельно.
Все данные заказа вымышлены и находятся в строке. ЧтениеHTML разбирает данные, но не является браузером: форма не отправляется, ссылки не открываются, картинки не скачиваются.
Никакие файлы, адреса сайтов, токены и документы информационной базы не нужны. Не заменяйте учебную строку произвольным внешним HTML без отдельной проверки безопасности.
Индексы коллекций начинаются с нуля. Перед обращением к найденному узлу проверяйте Неопределено; перед специальными свойствами элемента проверяйте его тип.
HTML = "<html><head><title>Учебный заказ</title><meta id='meta' name='description' content='Вымышленный заказ'></head>
|<body id='body'><p id='note'>Заказ существует только в памяти</p><pre id='code'>A-01: 3
|B-02: 1</pre>
|<form id='order' name='order' action='' method='get'>
|<input id='customer' name='customer' type='text' value='Учебный покупатель'>
|<input id='accepted' name='accepted' type='checkbox' value='yes'>
|<button id='preview' name='preview' type='button' value='preview'>Предпросмотр</button></form>
|<table id='items' summary='Книга и ручка'><caption id='caption'>Товары</caption><colgroup><col id='column'></colgroup><tbody>
|<tr id='book'><td id='book-name'>Книга</td><td>3</td></tr><tr id='pen'><td>Ручка</td><td>1</td></tr>
|</tbody></table><a id='help' name='help' href='#note'>Пояснение</a><img id='logo' alt='Учебная картинка без источника'>
|</body></html>";
Чтение = Новый ЧтениеHTML;
Чтение.УстановитьСтроку(HTML);
Попытка
Построитель = Новый ПостроительDOM;
Документ = Построитель.Прочитать(Чтение);
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
Если ТипЗнч(Документ) <> Тип("ДокументHTML") Тогда
ВызватьИсключение "Ожидался ДокументHTML, а не XML-документ";
КонецЕсли;
Поле = Документ.ПолучитьЭлементПоИдентификатору("customer");
Если Поле = Неопределено Тогда
ВызватьИсключение "Не найден учебный элемент customer";
КонецЕсли;
Если ТипЗнч(Поле) <> Тип("ЭлементВводаHTML") Тогда
ВызватьИсключение "Неожиданный тип учебного элемента customer";
КонецЕсли;
Поле.Значение = "Другой учебный покупатель";
Запись = Новый ЗаписьHTML;
Запись.УстановитьСтроку();
Попытка
Сериализатор = Новый ЗаписьDOM;
Сериализатор.Записать(Документ, Запись);
Исключение
Запись.Закрыть();
ВызватьИсключение;
КонецПопытки;
Результат = Запись.Закрыть();
ПовторноеЧтение = Новый ЧтениеHTML;
ПовторноеЧтение.УстановитьСтроку(Результат);
Попытка
ПовторныйДокумент = Построитель.Прочитать(ПовторноеЧтение);
Исключение
ПовторноеЧтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
ПовторноеЧтение.Закрыть();
ПовторноеПоле = ПовторныйДокумент.ПолучитьЭлементПоИдентификатору("customer");
Если ПовторноеПоле = Неопределено Тогда
ВызватьИсключение "После сериализации поле не найдено";
КонецЕсли;
Сообщить(ПовторноеПоле.Значение = "Другой учебный покупатель");
Сообщить(ПовторныйДокумент.Формы.Количество() = 1);Разбор по шагам
УстановитьСтроку задаёт приёмник памяти, не путь к файлу.
ЗаписьDOM сериализует настоящее дерево HTML в подготовленный приёмник.
Закрываем ресурсы и при успехе, и при исключении; повторный парсер получает результирующую строку.
Проверяем сохранение значения и формы, не сравниваем сериализацию побайтно с исходным HTML.
Как проверить результат
Два сравнения дают Истина: изменённый покупатель и одна форма сохранились.
Файлы и база не изменились. Регистр тегов, кавычки и форматирование могут отличаться от исходной строки.
Ожидаемый результат
Получена переносимая строка собственного HTML с проверкой повторного чтения.
На что обратить внимание
Полученная строка не равна опубликованной или исполненной странице.
Для произвольного внешнего HTML отдельно нужны ограничения размера и проверка безопасности отображения.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Записать HTML в поток памяти и прочитать обратно в UTF-8
Переходим от строки к байтам без диска. Явная UTF-8 сохраняет кириллицу покупателя, а повторный разбор проверяет смысл данных.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте учебную базу платформы 8.5.1.1343 и серверную процедуру учебного общего модуля. Каждый пример выполняйте отдельно.
Все данные заказа вымышлены и находятся в строке. ЧтениеHTML разбирает данные, но не является браузером: форма не отправляется, ссылки не открываются, картинки не скачиваются.
Никакие файлы, адреса сайтов, токены и документы информационной базы не нужны. Не заменяйте учебную строку произвольным внешним HTML без отдельной проверки безопасности.
Индексы коллекций начинаются с нуля. Перед обращением к найденному узлу проверяйте Неопределено; перед специальными свойствами элемента проверяйте его тип.
HTML = "<html><head><title>Учебный заказ</title><meta id='meta' name='description' content='Вымышленный заказ'></head>
|<body id='body'><p id='note'>Заказ существует только в памяти</p><pre id='code'>A-01: 3
|B-02: 1</pre>
|<form id='order' name='order' action='' method='get'>
|<input id='customer' name='customer' type='text' value='Учебный покупатель'>
|<input id='accepted' name='accepted' type='checkbox' value='yes'>
|<button id='preview' name='preview' type='button' value='preview'>Предпросмотр</button></form>
|<table id='items' summary='Книга и ручка'><caption id='caption'>Товары</caption><colgroup><col id='column'></colgroup><tbody>
|<tr id='book'><td id='book-name'>Книга</td><td>3</td></tr><tr id='pen'><td>Ручка</td><td>1</td></tr>
|</tbody></table><a id='help' name='help' href='#note'>Пояснение</a><img id='logo' alt='Учебная картинка без источника'>
|</body></html>";
Чтение = Новый ЧтениеHTML;
Чтение.УстановитьСтроку(HTML);
Попытка
Построитель = Новый ПостроительDOM;
Документ = Построитель.Прочитать(Чтение);
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
Если ТипЗнч(Документ) <> Тип("ДокументHTML") Тогда
ВызватьИсключение "Ожидался ДокументHTML, а не XML-документ";
КонецЕсли;
Поток = Новый ПотокВПамяти;
Запись = Новый ЗаписьHTML;
Попытка
Запись.ОткрытьПоток(Поток, "UTF-8", Ложь);
ЗаписьДерева = Новый ЗаписьDOM;
ЗаписьДерева.Записать(Документ, Запись);
Запись.Закрыть();
Данные = Поток.ЗакрытьИПолучитьДвоичныеДанные();
Исключение
Запись.Закрыть();
Поток.Закрыть();
ВызватьИсключение;
КонецПопытки;
Сообщить(Данные.Размер() > 0);
ВходнойПоток = Данные.ОткрытьПотокДляЧтения();
ЧтениеКопии = Новый ЧтениеHTML;
Попытка
ЧтениеКопии.ОткрытьПоток(ВходнойПоток, "UTF-8");
Копия = Построитель.Прочитать(ЧтениеКопии);
Исключение
ЧтениеКопии.Закрыть();
ВходнойПоток.Закрыть();
ВызватьИсключение;
КонецПопытки;
ЧтениеКопии.Закрыть();
ВходнойПоток.Закрыть();
Если ТипЗнч(Копия) <> Тип("ДокументHTML") Тогда
ВызватьИсключение "Ожидался HTML-документ после чтения потока";
КонецЕсли;
Покупатель = Копия.ПолучитьЭлементПоИдентификатору("customer");
Если Покупатель = Неопределено Тогда
ВызватьИсключение "Покупатель не сохранился в учебном обмене";
КонецЕсли;
Если ТипЗнч(Покупатель) <> Тип("ЭлементВводаHTML") Тогда
ВызватьИсключение "Проверьте тип покупателя после повторного чтения";
КонецЕсли;
Сообщить(Покупатель.Значение = "Учебный покупатель");
Сообщить(Копия.Формы.Количество() = 1);Разбор по шагам
ОткрытьПоток задаёт байтовый приёмник; UTF-8 и отсутствие BOM заданы явно.
ЗаписьDOM сериализует дерево в ЗаписьHTML; завершаем запись, затем забираем содержимое потока.
Для чтения создаём отдельный поток из готовых ДвоичныеДанные и явно задаём ту же кодировку.
Закрываем оба уровня ресурса в успешной ветке и при ошибке; не повторяем операции на закрытом потоке.
Как проверить результат
Три проверки Истина: непустые байты, кириллический покупатель и одна форма.
Точный размер байтов и расположение пробелов не считаем эталоном: проверяем значения после разбора.
Ожидаемый результат
Выполнен учебный обмен HTML через байты в памяти, без файла или сети.
На что обратить внимание
Строка в памяти не имеет UTF-8-байтов до кодирования; кодировку задаём на границе потока.
ЗакрытьИПолучитьДвоичныеДанные завершает работу потока; после этого используем только полученные данные.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.