Асинхронно прочитать часть, преобразовать результат и переписать его в поток

Читаем ABC из ABCDE. Результат обещания чтения ещё не является буфером: отдельно ожидаем получение буфера и двоичных данных.

Подготовка

1. Создайте учебную внешнюю обработку с пустой управляемой основной формой. Создайте команду УчебныйПример и кнопку этой команды.

2. В свойстве команды Действие выберите процедуру УчебныйПример. Вставьте полный приведённый модуль формы.

3. Откройте EPF в тонком или толстом клиенте Windows и нажмите кнопку. Не переносите Ждать и Асинх в серверный общий модуль.

4. Пример работает только со своими данными в памяти; записи в базу, файлы и сеть нет.

&НаКлиенте
Асинх Процедура УчебныйПример(Команда)
    Данные = ПолучитьДвоичныеДанныеИзСтроки("ABCDE", КодировкаТекста.UTF8, Ложь);
    Чтение = Новый ЧтениеДанных(Данные);
    Попытка
        Часть = Ждать Чтение.ПрочитатьАсинх(3);
        Буфер = Ждать Часть.ПолучитьБуферДвоичныхДанныхАсинх();
        Двоичные = Ждать Часть.ПолучитьДвоичныеДанныеАсинх();
        Сообщить(Часть.Размер = 3 И Буфер.Размер = 3 И Двоичные.Размер() = 3);
        Сообщить(ПолучитьСтрокуИзБуфераДвоичныхДанных(Буфер, КодировкаТекста.UTF8) = "ABC");
        Сообщить(ПолучитьСтрокуИзДвоичныхДанных(Двоичные, КодировкаТекста.UTF8) = "ABC");
        Ждать Чтение.ЗакрытьАсинх();
    Исключение
        Чтение.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
    Поток = Новый ПотокВПамяти;
    Запись = Новый ЗаписьДанных(Поток);
    Попытка
        Ждать Запись.ЗаписатьАсинх(Часть);
        Ждать Запись.ЗакрытьАсинх();
    Исключение
        Запись.Закрыть();
        Поток.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
    Копия = Поток.ЗакрытьИПолучитьДвоичныеДанные();
    Сообщить(ПолучитьСтрокуИзДвоичныхДанных(Копия, КодировкаТекста.UTF8) = "ABC");
КонецПроцедуры

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

1. Ждать ПрочитатьАсинх(3) даёт РезультатЧтенияДанных с тремя байтами, а не строку ABC.

2. ПолучитьБуферДвоичныхДанныхАсинх и ПолучитьДвоичныеДанныеАсинх — отдельные операции с собственными обещаниями.

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

4. ЗаписатьАсинх принимает сам результат чтения. В новый поток попадает ABC, не весь исходный ABCDE.

5. Закрываем оболочку записи до извлечения результата из своего потока.

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

1. Часть, буфер и двоичные данные имеют размер 3; все четыре сообщения Истина.

2. В восстановленной копии только ABC, букв DE нет.

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

Различены Обещание, РезультатЧтенияДанных, БуферДвоичныхДанных и ДвоичныеДанные.

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

1. Получение полного буфера загружает часть в память. Не повторяйте оба преобразования для огромного результата без нужды.

2. Ждать не преобразует двоичные данные в текст автоматически: декодирование UTF-8 выполняется явно.

3. После закрытия чтения не пытайтесь прочитать оставшиеся DE этим экземпляром.

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