класс ara::diag::OperationCycle

Класс ara::diag::OperationCycle предоставляет приложению функции для управления и отслеживания диагностических рабочих циклов [SWS_DM_00752]. Экземпляры привязываются к смоделированному порту через ara::core::InstanceSpecifier, не поддерживают ни копирование, ни перемещение и могут существовать в процессе только в единственном числе для каждого идентификатора. С помощью SetNotifier можно зарегистрировать уведомление об изменениях цикла, а с помощью RestartOperationCycle — инициировать перезапуск рабочего цикла [SWS_DM_01102]. За исключением потокобезопасного конструктора, все методы, а также деструктор не являются потокобезопасными и требуют синхронизации на стороне приложения при параллельном доступе.

больше ›

Контекст

Класс ara::diag::OperationCycle реализует DiagnosticOperationCycleInterface в рамках диагностики AUTOSAR Adaptive и предоставляет функции для обработки рабочих циклов и управления ими. Он служит интерфейсом между адаптивным приложением и управлением диагностикой для отслеживания или целенаправленного сброса состояний рабочих циклов.

Подключение к общей системе осуществляется через ara::core::InstanceSpecifier, передаваемый при вызове конструктора [SWS_DM_00752]. Этот идентификатор ссылается на PortPrototype, определенный в модели. При этом модель предписывает однозначное сопоставление: PortPrototype, на который ссылается DiagnosticOperationCyclePortMapping, должен типизироваться с помощью DiagnosticOperationCycleInterface [SWS_DM_00752]. Помимо управления, класс взаимодействует через интерфейс обратного вызова типа ara::diag::OperationCycle::OperationCycleSetNotifier (определенный как std::function<void(void)>), через который в приложение передаются уведомления об изменении рабочего цикла [SWS_DM_02078], [SWS_DM_00755].

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

Создание ara::diag::OperationCycle выполняется явно путем указания спецификации экземпляра порта через конструктор OperationCycle(const ara::core::InstanceSpecifier &specifier) [SWS_DM_00752]. Конструктор специфицирован как безопасный относительно исключений (exception safe) и потокобезопасный (thread-safe) [SWS_DM_00752].

С точки зрения семантики владения и копирования класс смоделирован как строгий одиночный объект, представляющий фиксированную привязку 1:1 к смоделированному порту. Копирование и перемещение полностью запрещены:

• Конструктор копирования удален (delete), чтобы исключить дублирование [SWS_DM_01598].
• Конструктор перемещения удален (delete) [SWS_DM_01599].
• Оператор присваивания с копированием удален (delete) [SWS_DM_01596].
• Оператор присваивания с перемещением удален (delete) [SWS_DM_01597].

Кроме того, фреймворк запрещает множественное использование: InstanceSpecifier не может повторно использоваться для инстанцирования в рамках одного и того же процесса [SWS_DM_00752]. Освобождение происходит в деструкторе ~OperationCycle() [SWS_DM_00753]. В отличие от конструктора, деструктор не является потокобезопасным (not thread-safe), хотя и объявлен безопасным относительно исключений [SWS_DM_00753]. Другие методы класса, а также тип обратного вызова также не являются потокобезопасными [SWS_DM_00755], [SWS_DM_01102], [SWS_DM_02078], поэтому параллельный доступ к одному и тому же экземпляру должен синхронизироваться на стороне приложения.

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

Типичный сценарий использования включает инстанцирование, опциональную регистрацию обработчика изменений цикла, многократный запуск перезапуска цикла, а также освобождение:

1. Инстанцирование: приложение создает объект OperationCycle, передавая соответствующий InstanceSpecifier [SWS_DM_00752].
2. Регистрация нотификатора: с помощью метода SetNotifier приложение регистрирует функцию обратного вызова типа OperationCycleSetNotifier [SWS_DM_00755], [SWS_DM_02078]. Эта функция вызывается при изменении рабочего цикла. Последовательный вызов SetNotifier полностью перезаписывает ранее зарегистрированный нотификатор [SWS_DM_00755].
3. Перезапуск рабочего цикла: с помощью RestartOperationCycle() приложение инициирует перезапуск рабочего цикла [SWS_DM_01102]. Управление диагностикой обновляет цикл и при смене статуса уведомляет зарегистрированный обратный вызов [SWS_DM_00755]. При этом уведомление, по-видимому, происходит асинхронно в контексте управления диагностикой. Вопрос Q-7cd22debf6fa91d7 (открытый)
4. Уничтожение: при завершении работы программного компонента объект уничтожается с помощью деструктора [SWS_DM_00753].

Диаграмма последовательности: процесс инстанцирования, регистрации нотификатора и перезапуска рабочего цикла. Источники: [SWS_DM_00752], [SWS_DM_00755], [SWS_DM_01102], [SWS_DM_02078].

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

Ошибки при инициализации сигнализируются фреймворком как нарушения (Violations), поскольку конструктор объявлен как noexcept [SWS_DM_00752]:

• InstanceSpecifierMappingIntegrityViolation: InstanceSpecifier не удается разрешить в контексте исполняемого файла или он указывает на элемент, который не является PortPrototype [SWS_DM_00752].
• PortInterfaceMappingViolation: PortPrototype, на который ссылается DiagnosticOperationCyclePortMapping, не типизирован с помощью DiagnosticOperationCycleInterface [SWS_DM_00752].
• ProcessMappingViolation: хотя подходящая ссылка на экземпляр существует, подходящий смоделированный процесс для процесса времени выполнения не найден [SWS_DM_00752].
• InstanceSpecifierAlreadyInUseViolation: конструктор был вызван с InstanceSpecifier, который уже используется в текущем процессе [SWS_DM_00752].

При штатной работе методы SetNotifier и RestartOperationCycle возвращают ara::core::Result<void> [SWS_DM_00755], [SWS_DM_01102]. Для обеих функций в стандарте не определены специфические коды ошибок («This function does not specify any standardized errors.») [SWS_DM_00755], [SWS_DM_01102]. Использование типа Result, по-видимому, служит в первую очередь для единообразного построения интерфейса и оставляет пространство для состояний ошибок, специфичных для реализации. Вопрос Q-2c59a287c0d5783a (открытый)