класс ara::rds::ReadDataResult

Структура ara::rds::ReadDataResult инкапсулирует результат операции чтения из потока необработанных данных AUTOSAR Adaptive Platform (AUTOSAR_AP_SWS_RawDataStream, с. 1). Она создаётся методами ReadData и предоставляет прочитанные бинарные данные в буфере data вместе с фактическим количеством байтов numberOfBytes [SWS_RDS_11301]. Поскольку буфер управляется как std::unique_ptr, структура, вероятно, передаёт эксклюзивное владение вызывающей стороне и исключает копирование. Вопрос (открытый) Ошибки сообщаются через охватывающий ara::core::Result, поэтому результат необходимо валидировать перед доступом к данным.

больше ›

Контекст

Класс ara::rds::ReadDataResult функционирует в модуле rds (RawDataStream) AUTOSAR Adaptive Platform как структурированный контейнер результатов для извлечения данных из потоков данных (AUTOSAR_AP_SWS_RawDataStream, с. 1). Его основная обязанность состоит в передаче прочитанных из потока необработанных данных байтов вместе с фактически переданным количеством байтов вызывающему приложению. В качестве партнёров по взаимодействию в системном комплексе выступают экземпляры потоков, предлагающие методы чтения ReadData, а также соответствующий компонент приложения, анализирующий поток данных и обрабатывающий данные далее [SWS_RDS_10486], [SWS_RDS_11322].

Жизненный цикл

Экземпляры ara::rds::ReadDataResult возникают в рамках синхронных или ограниченных по времени операций чтения. Создание инициируется, когда вызывающая сторона вызывает метод ReadData(std::size_t maxLength) [SWS_RDS_10486], [SWS_RDS_11322] или перегрузку с контролем времени ожидания ReadData(std::size_t maxLength, std::chrono::milliseconds timeout) [SWS_RDS_11309], [SWS_RDS_11323].

Отношения владения и жизненный цикл памяти существенно определяются содержащимся элементом данных data, который объявлен как std::unique_ptr<ara::core::Byte[]> [SWS_RDS_11301]. Согласно общепринятой интерпретации C++, это означает, что ReadDataResult, вероятно, спроектирован как тип только для перемещения (move-only) и, следовательно, не может копироваться, а только перемещаться. Вопрос Q-fe4b113c5852b5aa (открытый) Вызывающая программа с получением объекта принимает единоличное владение выделенным буфером данных. Уничтожение экземпляра автоматически приводит к освобождению зарезервированной памяти кучи байтового массива, если только указатель ранее не был явно извлечён из объекта. В отношении многопоточности внутренняя синхронизация отсутствует; конкурентный доступ к экземпляру из нескольких потоков без внешних блокировок не является потокобезопасным.

Путь использования

Штатный процесс использования ara::rds::ReadDataResult подразделяется на следующие шаги:

• Запрос операции чтения: приложение вызывает у потока ReadData с максимально желаемым объёмом данных maxLength [SWS_RDS_10486], [SWS_RDS_11322], опционально дополненным значением таймаута [SWS_RDS_11309], [SWS_RDS_11323].
• Возврат контейнера результатов: поток считывает бинарные данные из канала и при успехе возвращает заполненный объект типа ara::core::Result<ReadDataResult> (AUTOSAR_AP_SWS_RawDataStream, с. 1).
• Определение размера: приложение считывает поле numberOfBytes из [SWS_RDS_11302]. Интерпретация: это значение, вероятно, указывает фактически предоставленный в буфере объём байтов, который может быть меньше или равен запрошенному maxLength. Вопрос Q-12bde8c67452a632 (открытый)
• Обработка данных: буфер data разыменовывается [SWS_RDS_11301] для обработки полученных байтов или их переноса с помощью семантики перемещения в собственные структуры приложения.

Диаграмма последовательности: типичный процесс операции чтения с приёмом и обработкой ReadDataResult. Источники: [SWS_RDS_10486], [SWS_RDS_11301], [SWS_RDS_11302], AUTOSAR_AP_SWS_RawDataStream, с. 1

Сценарии ошибок

Методы для создания ReadDataResult объявлены с noexcept [SWS_RDS_10486], [SWS_RDS_11309], [SWS_RDS_11322], [SWS_RDS_11323], поэтому в случае ошибки исключения C++ не выбрасываются. Вместо этого обработка ошибок полностью осуществляется через возвращаемый объект ara::core::Result (AUTOSAR_AP_SWS_RawDataStream, с. 1).

Типичные сценарии ошибок включают прерывания потока, недопустимые запросы на чтение или истечение времени ожидания при вызовах чтения с контролем таймаута [SWS_RDS_11309], [SWS_RDS_11323]. Интерпретация: при таких сбоях ara::core::Result, вероятно, содержит не валидный объект ReadDataResult, а соответствующий код ошибки. Вопрос Q-f3f971c4789fe8e7 (открытый) Для приложения это означает в качестве предварительного условия для доступа к data [SWS_RDS_11301] и numberOfBytes [SWS_RDS_11302] обязательную предварительную проверку успешного состояния вышестоящего объекта Result, чтобы предотвратить доступ к неинициализированным указателям или недопустимым областям памяти.