класс ara::rds::IEEE1722RawDataStreamProducer

Шаблонный класс ara::rds::IEEE1722RawDataStreamProducer служит в AUTOSAR Adaptive Platform для отправки типизированных телеграмм потока данных согласно стандарту IEEE 1722 (AUTOSAR_AP_SWS_RawDataStream, с. 1). После статического создания с помощью Create соединение устанавливается через Connect, после чего полезные данные передаются через WriteData в виде вектора [SWS_RDS_90332]. Класс обладает строгой семантикой перемещения (move-only) и не является потокобезопасным при операциях перемещения, а также в деструкторе. Явный вызов Shutdown или уничтожение объекта корректно закрывает соединение.

больше ›

Контекст

Шаблонный класс ara::rds::IEEE1722RawDataStreamProducer предоставляет в рамках модуля rds (Raw Data Stream) платформы AUTOSAR Adaptive Platform интерфейс для отправки типизированных датаграмм потока данных согласно стандарту IEEE 1722 (AUTOSAR_AP_SWS_RawDataStream, с. 1). В качестве компонента-производителя (producer) он инкапсулирует специфичное для канала и протокола установление соединения, а также транспортировку полезных данных через нижележащую сеть.

Адресация и программная привязка к сконфигурированному экземпляру потока осуществляются путем передачи ara::core::InstanceSpecifier в метод создания [SWS_RDS_90323]. Основными партнерами по взаимодействию являются использующее программное обеспечение, создающее элементы данных шаблонного типа T, а также сетевой стек IEEE 1722, который физически транспортирует датаграммы. Определение класса подключается через заголовочный файл #include "ara/rds/raw_data_stream_IEEE1722.h" [SWS_RDS_90323].

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

Инстанцирование ara::rds::IEEE1722RawDataStreamProducer выполняется исключительно через статический фабричный метод Create [SWS_RDS_90323]. Класс подчиняется строгой семантике перемещения (move-only): конструктор копирования [SWS_RDS_90327] и оператор присваивания с копированием [SWS_RDS_90328] удалены (=delete), что предотвращает дублирование ресурсов.

Передача экземпляра другим владельцам возможна через конструктор перемещения [SWS_RDS_90324] и оператор присваивания с перемещением [SWS_RDS_90326]. Что касается конкурентности, операции перемещения и деструктор объявлены как непотокобезопасные [SWS_RDS_90324], [SWS_RDS_90326], [SWS_RDS_90329]; одновременный доступ из разных потоков требует внешней синхронизации.

После создания производитель изначально находится в разъединенном состоянии. Соединение устанавливается через Connect [SWS_RDS_90330]. Завершение соединения происходит либо явно через Shutdown [SWS_RDS_90331], либо автоматически при уничтожении экземпляра: деструктор ~IEEE1722RawDataStreamProducer() гарантирует корректное завершение работы все еще открытого соединения [SWS_RDS_90329].

Диаграмма состояний: фазы жизненного цикла производителя от создания через установление соединения до закрытия. Источники: [SWS_RDS_90323], [SWS_RDS_90330], [SWS_RDS_90331], [SWS_RDS_90329], [SWS_RDS_90332].

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

Штатный процесс передачи потоков данных IEEE 1722 делится на следующие фазы:

1. Создание: приложение инстанцирует производитель через Create с указанием идентификатора instance [SWS_RDS_90323] и принимает возвращенный экземпляр.
2. Установление соединения: перед передачей данных приложение вызывает Connect [SWS_RDS_90330], чтобы открыть канал связи.
3. Передача данных: затем датаграммы передаются в сеть в виде вектора типа T с помощью WriteData(std::vector<T> data) [SWS_RDS_90332]. Этот шаг может повторяться циклически или по событиям.
4. Разрыв соединения: после завершения передач Shutdown явно завершает соединение [SWS_RDS_90331]. В качестве альтернативы деструктор закрывает соединение при выходе из области видимости [SWS_RDS_90329].

Диаграмма последовательности: типичный процесс передачи данных от инстанцирования до разрыва соединения. Источники: [SWS_RDS_90323], [SWS_RDS_90330], [SWS_RDS_90332], [SWS_RDS_90331].

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

Операции класса специфицированы как noexcept и используют модель ошибок ara::core::Result:

• Create возвращает ara::core::Result<IEEE1722RawDataStreamProducer<T>> [SWS_RDS_90323]. При некорректной конфигурации или нехватке ресурсов результат содержит соответствующий код ошибки вместо экземпляра.
• Connect сообщает о неудачном установлении соединения через ara::core::Result<void> [SWS_RDS_90330].
• WriteData возвращает ara::core::Result<void> [SWS_RDS_90332]. Интерпретация: вызов, предположительно, требует предварительно успешного установления соединения с помощью Connect; при отсутствии соединения или внутренних ошибках отправки возвращается ошибка. Вопрос Q-ee438b8710c58062 (открытый)
• Shutdown также сигнализирует о возможных ошибках при закрытии соединения через ara::core::Result<void> [SWS_RDS_90331].

Интерпретация: конкретные значения ara::core::ErrorCode не специфицированы в выдержке из интерфейса и должны проверяться в зависимости от приложения через возвращаемый Result. Вопрос Q-472e6d4a603c883d (открытый)