Получает результат чтения в виде двоичных данных.
Синтаксис
ПолучитьДвоичныеДанные()Полное описание, параметры и ограничения
РезультатЧтенияДанных.ПолучитьДвоичныеДанные (ReadDataResult.GetBinaryData)
РезультатЧтенияДанных (ReadDataResult)
ПолучитьДвоичныеДанные (GetBinaryData)
Доступен, начиная с версии 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: должна сработать проверка неполного названия.
Ожидаемый результат
Пакет прочитан с проверкой версии, ограничением размера и контролем неполного тела.
На что обратить внимание
Для сетевого потока частичное чтение может быть нормальным: в реальном сетевом протоколе собирайте тело циклом до нужного размера или завершения потока.
Нельзя доверять длине из внешнего пакета без верхнего ограничения: иначе можно выделить чрезмерную память.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Разобрать свою запись: заголовок, название, код, статус и хвост
Полный callback-модуль разбирает HDR|Книга#A-01Готов + ПС + END. У каждого поля есть явное правило границы или длины.
Где и как запускать
Модуль пустой управляемой формы учебной внешней обработки; тонкий или толстый клиент Windows. Вставьте весь модуль. Это не серверный код.
Подготовка
Создайте учебную внешнюю обработку с пустой управляемой основной формой. Создайте команду УчебныйПример и кнопку этой команды.
В свойстве команды Действие выберите процедуру УчебныйПример. Вставьте полный приведённый модуль формы.
Откройте EPF в тонком или толстом клиенте Windows и нажмите кнопку. Не переносите Ждать и Асинх в серверный общий модуль.
Пример работает только со своими данными в памяти; записи в базу, файлы и сеть нет.
Перем Выполняется;
&НаКлиенте
Процедура УчебныйПример(Команда)
Если Выполняется = Истина Тогда
Сообщить("Дождитесь завершения предыдущей учебной цепочки");
Возврат;
КонецЕсли;
Данные = ПолучитьДвоичныеДанныеИзСтроки("HDR|Книга#A-01Готов" + Символы.ПС + "END", КодировкаТекста.UTF8, Ложь);
Чтение = Новый ЧтениеДанных(Данные, КодировкаТекста.UTF8, , Символы.ПС);
Целевой = Новый ПотокВПамяти;
Состояние = Новый Структура("Чтение,ЧтениеЗакрыто,Целевой,ЦелевойЗакрыт", Чтение, Ложь, Целевой, Ложь);
Выполняется = Истина;
Попытка
Состояние.Чтение.НачатьПропуск(ОповещениеДля("ПослеЗаголовка", Состояние), 3);
Исключение
ОсвободитьУчебныеРесурсы(Состояние);
Выполняется = Ложь;
ВызватьИсключение;
КонецПопытки;
КонецПроцедуры
&НаКлиенте
Функция ОповещениеДля(ИмяОбработчика, Состояние)
Возврат Новый ОписаниеОповещения(ИмяОбработчика, ЭтотОбъект, Состояние,
"ОшибкаОперации", ЭтотОбъект);
КонецФункции
&НаКлиенте
Процедура ОшибкаОперации(Ошибка, СтандартнаяОбработка, Состояние) Экспорт
ОсвободитьУчебныеРесурсы(Состояние);
Выполняется = Ложь;
СтандартнаяОбработка = Истина;
КонецПроцедуры
&НаКлиенте
Процедура ОсвободитьУчебныеРесурсы(Состояние)
Попытка
Если Не Состояние.ЧтениеЗакрыто Тогда
Состояние.Чтение.Закрыть();
Состояние.ЧтениеЗакрыто = Истина;
КонецЕсли;
Если Не Состояние.ЦелевойЗакрыт Тогда
Состояние.Целевой.Закрыть();
Состояние.ЦелевойЗакрыт = Истина;
КонецЕсли;
Исключение
// Не заменяем первичную ошибку вторичной ошибкой освобождения ресурсов.
КонецПопытки;
КонецПроцедуры
&НаКлиенте
Процедура ПослеЗаголовка(Количество, Состояние) Экспорт
Если Количество <> 3 Тогда
ОсвободитьУчебныеРесурсы(Состояние);
Выполняется = Ложь;
ВызватьИсключение "Заголовок учебной записи неполный";
КонецЕсли;
Состояние.Чтение.НачатьПропускДо(ОповещениеДля("ПослеГраницы", Состояние), "|", КодировкаТекста.UTF8);
КонецПроцедуры
&НаКлиенте
Процедура ПослеГраницы(ИндексМаркера, Состояние) Экспорт
Если ИндексМаркера = -1 Тогда
ОсвободитьУчебныеРесурсы(Состояние);
Выполняется = Ложь;
ВызватьИсключение "Нет обязательной границы |";
КонецЕсли;
Состояние.Чтение.НачатьЧтениеДо(ОповещениеДля("ПослеНазвания", Состояние), "#", КодировкаТекста.UTF8);
КонецПроцедуры
&НаКлиенте
Процедура ПослеНазвания(Результат, Состояние) Экспорт
Если Не Результат.МаркерНайден Тогда
ОсвободитьУчебныеРесурсы(Состояние);
Выполняется = Ложь;
ВызватьИсключение "Нет обязательной границы названия #";
КонецЕсли;
Сообщить(ПолучитьСтрокуИзДвоичныхДанных(Результат.ПолучитьДвоичныеДанные(), КодировкаТекста.UTF8) = "Книга");
Состояние.Чтение.НачатьЧтениеСимволов(ОповещениеДля("ПослеКода", Состояние), 4);
КонецПроцедуры
&НаКлиенте
Процедура ПослеКода(Код, Состояние) Экспорт
Сообщить(Код = "A-01");
Состояние.Чтение.НачатьЧтениеСтроки(ОповещениеДля("ПослеСтатуса", Состояние));
КонецПроцедуры
&НаКлиенте
Процедура ПослеСтатуса(Статус, Состояние) Экспорт
Сообщить(Статус = "Готов");
Состояние.Чтение.НачатьКопированиеВ(ОповещениеДля("ПослеКопирования", Состояние), Состояние.Целевой);
КонецПроцедуры
&НаКлиенте
Процедура ПослеКопирования(Количество, Состояние) Экспорт
Сообщить(Количество = 3);
Состояние.Чтение.НачатьЗакрытие(ОповещениеДля("ПослеЗакрытияЧтения", Состояние));
КонецПроцедуры
&НаКлиенте
Процедура ПослеЗакрытияЧтения(Состояние) Экспорт
Состояние.ЧтениеЗакрыто = Истина;
Тело = Состояние.Целевой.ЗакрытьИПолучитьДвоичныеДанные();
Состояние.ЦелевойЗакрыт = Истина;
Сообщить(ПолучитьСтрокуИзДвоичныхДанных(Тело, КодировкаТекста.UTF8) = "END");
Выполняется = Ложь;
КонецПроцедурыРазбор по шагам
Заголовок HDR занимает три ASCII-байта; проверяем фактически пропущенное количество.
Название заканчивается #. Прежде чем считать результат корректным, проверяем обязательную границу | и затем МаркерНайден для #.
Код A-01 имеет фиксированные четыре СИМВОЛА; НачатьЧтениеСимволов использует символы, не количество байтов.
Статус читаем до заданного ПС. Callback получает строку Готов без разделителя.
Оставшийся двоичный хвост копируем в новый поток. Количество в callback копирования — фактическое число байтов.
Ресурсы закрываются после завершения соответствующих операций; форма запрещает перекрывающиеся запуски.
Как проверить результат
Пять сравнений Истина: Книга, A-01, Готов, три скопированных байта, END.
Удалите # во входной строке: пример прекращает разбор с сообщением об отсутствующей границе.
Ожидаемый результат
Разобрана собственная структурированная запись с разными правилами полей и точными callback-результатами.
На что обратить внимание
Это учебная запись, не реальный формат Авито/1С. Здесь специально не предусмотрены вложенные # в названии.
ПропуститьДо ищет границу дальше по потоку, а не проверяет её строго в текущей позиции; для строгого протокола дополнительно проверяйте позиционные ограничения.
ПолучитьДвоичныеДанные внутри callback синхронно допустим в указанном Windows-клиенте; веб-клиент не заявлен.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.