структура <ExtendedDataRecord-Namespace>::<ExtendedDataRecordElementInterface>::<ExtendedDataRecordElement>ReadOutput

В модуле диагностики AUTOSAR Adaptive Platform данная структура служит для инкапсуляции выходных аргументов при считывании элемента Extended Data Record. Она объединяет результирующие диагностические данные операции чтения в типизированном объекте, который передаётся от предоставляющего интерфейса вызывающему экземпляру диагностики. Предположительно, во время вызова структура данных заполняется полученными значениями и затем предоставляется для дальнейшей обработки или передачи по значению либо посредством move-семантики. Вопрос (открытый) Будучи чистым объектом данных без собственных механизмов синхронизации, при параллельном доступе она требует внешней координации со стороны участвующих компонентов.

больше ›

Контекст

Структура данных <ExtendedDataRecordElement>ReadOutput входит в состав модуля diag в рамках AUTOSAR Adaptive Platform (релиз R25-11). Она относится к пространству имён <ExtendedDataRecord-Namespace>::<ExtendedDataRecordElementInterface> и синтаксически объявлена как структура C++ (struct <ExtendedDataRecordElement>ReadOutput {...};). Согласно описанию спецификации, эта структура служит обёрткой для выходных аргументов операции чтения (Structure wrapping the out arguments for a ReadOutput).

В рамках адаптивного управления диагностикой записи Extended Data Records (EDR) берут на себя задачу предоставления дополнительной диагностической информации (специфичной для производителя или стандартизированной), такой как условия эксплуатации, измеренные значения или счетчики состояния на момент записи ошибки. При этом структура <ExtendedDataRecordElement>ReadOutput выступает в качестве выделенного объекта передачи данных для результатов запроса такого элемента записи данных. Вместо передачи возвращаемых значений через несколько отдельных выходных параметров или указателей данная структура объединяет формируемые выходные данные.

Основными партнерами по взаимодействию выступают запрашивающий экземпляр диагностики (например, диагностическая служба или среда выполнения ara::diag), а также реализация интерфейса <ExtendedDataRecordElementInterface> на стороне приложения. Интерпретация: предположительно, структура служит прежде всего для того, чтобы типобезопасно объединить возвращаемые значения вызова чтения на интерфейсе для Extended Data Records в ara::diag и предоставить их для дальнейшего потока данных. Вопрос Q-0b74f3ccd5993cf3 (открытый) Таким образом обеспечивается чистое разделение интерфейсов между предоставлением и обработкой данных.

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

Структура <ExtendedDataRecordElement>ReadOutput спроектирована как чистый агрегат данных C++ без собственной бизнес-логики или хранения состояния. Из этого вытекают однозначные характеристики создания, владения и уничтожения в системе.

Инстанцирование объекта происходит непосредственно в контексте выполняемого вызова чтения. Предоставляющий компонент создает экземпляр на стеке или в контексте асинхронной обработки и присваивает ему полученные выходные данные. Интерпретация: время жизни экземпляра, вероятно, привязано к соответствующему циклу выполнения и возврата операции чтения и завершается после обработки содержащихся данных вызывающей стороной. Вопрос Q-8df0c1a01d7b670d (открытый) Внутренних состояний и, следовательно, определённых переходов состояний не существует; после инициализации структура находится в неизменяемом или чисто пассивном состоянии чтения.

Что касается отношений владения, структура обычно передаётся вызывающей стороне по значению (by value) или с помощью move-семантики. Таким образом, владение полностью переходит к вызывающей стороне. При выходе из области видимости (scope) память детерминированно освобождается в соответствии со стандартными правилами деструкции C++.

В отношении параллелизма <ExtendedDataRecordElement>ReadOutput не содержит внутренних механизмов синхронизации, мьютексов или атомарных операций. Если экземпляр совместно используется несколькими потоками или пересылается по асинхронным конвейерам данных, ответственность за потокобезопасный доступ полностью лежит на окружающих программных компонентах диагностической системы.

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

Типичный сценарий использования описывает последовательность шагов при запросе диагностических данных через интерфейс <ExtendedDataRecordElementInterface>:

Сначала диагностическая служба или внутренняя диагностическая функция инициирует запрос на чтение для конкретного элемента Extended Data Record. Этот запрос адресуется операции чтения интерфейса. Интерпретация: в сценарии использования структура, предположительно, заполняется считанными значениями реализацией приложения или обработчика, а затем передаётся для дальнейшей обработки. Вопрос Q-14a94978fff8f96e (открытый) Реализация считывает актуальную диагностическую информацию из внутренних источников данных и инициализирует экземпляр <ExtendedDataRecordElement>ReadOutput этими значениями.

После инициализации экземпляр возвращается вызывающему диагностическому компоненту. Вызывающая сторона обращается к полям данных, содержащимся в структуре, для валидации значений, их сериализации или подготовки диагностического ответа в соответствии с диагностическим протоколом. Как только выходные данные успешно обработаны или перенесены в нижележащие области памяти, использование структуры завершается, и объект удаляется.