Получает результат в виде буфера двоичных данных. Необходимо учитывать, что при этом данные будут полностью загружены в оперативную память. Если требуется избежать загрузки оперативной памяти, следует использовать другие методы получения двоичных данных.
Синтаксис
ПолучитьБуферДвоичныхДанных()Полное описание, параметры и ограничения
РезультатЧтенияДанных.ПолучитьБуферДвоичныхДанных (ReadDataResult.GetBinaryDataBuffer)
РезультатЧтенияДанных (ReadDataResult)
ПолучитьБуферДвоичныхДанных (GetBinaryDataBuffer)
Доступен, начиная с версии 8.3.9.
Синтаксис:
ПолучитьБуферДвоичныхДанных()
Возвращаемое значение:
Тип: БуферДвоичныхДанных.
Описание:
Получает результат в виде буфера двоичных данных. Необходимо учитывать, что при этом данные будут полностью загружены в оперативную память. Если требуется избежать загрузки оперативной памяти, следует использовать другие методы получения двоичных данных.
Доступность:
Тонкий клиент, сервер, толстый клиент, внешнее соединение.
См. также:
РезультатЧтенияДанных, метод ПолучитьДвоичныеДанные
РезультатЧтенияДанных, метод НачатьПолучениеДвоичныхДанных
РезультатЧтенияДанных, метод ОткрытьПотокДляЧтения
РезультатЧтенияДанных, метод НачатьПолучениеБуфераДвоичныхДанных
РезультатЧтенияДанных, метод ПолучитьБуферДвоичныхДанныхАсинх
Использование в версии:
Доступен, начиная с версии 8.3.9.
Описание изменено в версии 8.3.18.
Методическая информация
Практические примеры
Собрать пакет с версией, количеством и UTF-8 названием
Пакет имеет согласованную структуру: 1 байт версии, 2 байта количества, 4 байта длины названия, затем UTF-8. Проверяем поля до чтения тела.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Серверный контекст, только память. Это учебный протокол, не формат какого-либо реального API.
Название кодируется в UTF-8 без BOM; целые записываются в LittleEndian.
В конструктор записи и чтения передаётся уже созданный поток: его закрываем отдельно после закрытия обоих объектов.
Название = ПолучитьБуферДвоичныхДанныхИзСтроки("Книга", КодировкаТекста.UTF8, Ложь);
Поток = Новый ПотокВПамяти;
Попытка
Запись = Новый ЗаписьДанных(Поток, КодировкаТекста.UTF8, ПорядокБайтов.LittleEndian);
Попытка
Запись.ЗаписатьБайт(1);
Запись.ЗаписатьЦелое16(3);
Запись.ЗаписатьЦелое32(Название.Размер);
Запись.ЗаписатьБуферДвоичныхДанных(Название);
Исключение
Запись.Закрыть();
ВызватьИсключение;
КонецПопытки;
Запись.Закрыть();
Сообщить(Поток.Размер());
Поток.Перейти(0, ПозицияВПотоке.Начало);
Чтение = Новый ЧтениеДанных(Поток, КодировкаТекста.UTF8, ПорядокБайтов.LittleEndian);
Попытка
Версия = Чтение.ПрочитатьБайт();
Если Версия <> 1 Тогда
ВызватьИсключение "Неподдерживаемая версия пакета";
КонецЕсли;
Количество = Чтение.ПрочитатьЦелое16();
Длина = Чтение.ПрочитатьЦелое32();
Если Количество = Неопределено Или Длина = Неопределено Тогда
ВызватьИсключение "Заголовок пакета оборван";
КонецЕсли;
Если Длина < 0 Или Длина > 1024 Тогда
ВызватьИсключение "Недопустимая длина названия";
КонецЕсли;
Результат = Чтение.Прочитать(Длина);
Если Результат.Размер <> Длина Тогда
ВызватьИсключение "Название получено не полностью";
КонецЕсли;
БуферНазвания = Результат.ПолучитьБуферДвоичныхДанных();
Сообщить(ПолучитьСтрокуИзБуфераДвоичныхДанных(БуферНазвания, КодировкаТекста.UTF8));
Сообщить(Количество);
Сообщить(Результат.ПолучитьДвоичныеДанные().Размер());
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
Исключение
Поток.Закрыть();
ВызватьИсключение;
КонецПопытки;
Поток.Закрыть();Разбор по шагам
Записываем поля заголовка в фиксированном порядке и длину тела в байтах.
Закрыть объекта записи сбрасывает её буферы, не закрывая переданный извне поток.
Возвращаем позицию в начало и читаем поля в том же порядке и с тем же порядком байтов.
Ограничиваем длину, проверяем фактический размер прочитанного тела и лишь затем декодируем название.
Как проверить результат
Размер пакета 17 байтов: 1 + 2 + 4 + 10; результат Книга и количество 3.
Замените записанную версию 1 на 2: чтение должно завершиться текстом Неподдерживаемая версия пакета.
Укажите при записи длину 100 вместо фактических 10: должна сработать проверка неполного названия.
Ожидаемый результат
Пакет прочитан с проверкой версии, ограничением размера и контролем неполного тела.
На что обратить внимание
Для сетевого потока частичное чтение может быть нормальным: в реальном сетевом протоколе собирайте тело циклом до нужного размера или завершения потока.
Нельзя доверять длине из внешнего пакета без верхнего ограничения: иначе можно выделить чрезмерную память.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Выделить значение до маркера и выбрать самый длинный совпадающий маркер
В строке KEY:Книга##TAIL маркеры # и ## совпадают в одном месте. Выбирается ##, а хвост читается отдельно.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте отдельную учебную базу. Фрагмент без директив вставьте в тело серверной процедуры ВыполнитьПример() Экспорт общего модуля УчебныеЗадачи.
Все исходные байты создаются самим примером в памяти. Файлы, сеть, справочники и документы не нужны.
Запускайте задачи отдельно. После закрытия ЧтениеДанных/ЗаписьДанных не используйте этот экземпляр повторно.
Данные = ПолучитьДвоичныеДанныеИзСтроки("KEY:Книга##TAIL", КодировкаТекста.UTF8, Ложь);
Чтение = Новый ЧтениеДанных(Данные, КодировкаТекста.UTF8);
Попытка
Маркеры = Новый Массив;
Маркеры.Добавить("#");
Маркеры.Добавить("##");
Значение = Чтение.ПрочитатьДо(Маркеры, КодировкаТекста.UTF8);
Если Не Значение.МаркерНайден Тогда
ВызватьИсключение "Не найден обязательный разделитель учебного сообщения";
КонецЕсли;
Сообщить(Значение.ИндексМаркера = 1);
ТекстЗначения = ПолучитьСтрокуИзБуфераДвоичныхДанных(Значение.ПолучитьБуферДвоичныхДанных(), КодировкаТекста.UTF8);
Сообщить(ТекстЗначения = "KEY:Книга");
Остаток = Чтение.ПрочитатьДо("НЕСУЩЕСТВУЮЩИЙ", КодировкаТекста.UTF8);
Сообщить(Не Остаток.МаркерНайден);
Сообщить(ПолучитьСтрокуИзДвоичныхДанных(Остаток.ПолучитьДвоичныеДанные(), КодировкаТекста.UTF8) = "TAIL");
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();Разбор по шагам
Массив хранит два маркера с нулевыми индексами 0 и 1.
ПрочитатьДо ищет ближайшую границу, а среди совпадений в этой позиции — маркер максимально возможной длины. Поэтому индекс 1 соответствует ##.
Сначала проверяем МаркерНайден, затем используем ИндексМаркера. Не полагаемся на индекс при отсутствии маркера.
Результат содержит данные перед границей, а не сам маркер. Следующее чтение начинается после ##.
Если второго заданного маркера нет, результат всё равно содержит остаток TAIL, но МаркерНайден равно Ложь. Это нужно обработать как отдельную ситуацию.
Как проверить результат
Первое значение KEY:Книга и индекс 1; второе значение TAIL без найденного маркера.
Все четыре сравнения Истина; обязательная граница не теряется среди коротких совпадений.
Ожидаемый результат
Разобрано сообщение с конкурирующими границами и отсутствующим маркером.
На что обратить внимание
Это учебный протокол, не готовый парсер HTTP multipart/CSV. Там есть дополнительные правила экранирования и границ.
Не декодируйте произвольный двоичный payload как UTF-8: кодировка относится к текстовой части.
ПолучитьБуферДвоичныхДанных загружает результат целиком в память; для больших частей используйте поток.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.