класс ara::idsm::ReportingModeProvider

Класс ara::idsm::ReportingModeProvider предоставляет механизмы для запроса и установки Reporting Modes для событий безопасности в Intrusion Detection System Manager [SWS_AIDSM_10600]. Инстанцирование выполняется потокобезопасно через ara::core::InstanceSpecifier для смоделированного PPort [SWS_AIDSM_10601]. Во время выполнения методы GetReportingMode и SetReportingMode позволяют считывать и изменять режим сконфигурированного события. Поскольку эти методы не являются потокобезопасными, параллельный доступ должен быть синхронизирован извне. При неизвестных Event-ID методы возвращают ошибку IdsmErrc::kUnknownEventId.

больше ›

Контекст

Класс ara::idsm::ReportingModeProvider определен в заголовочном файле ara/idsm/reporting_mode_provider.h и служит внутри Adaptive-модуля idsm для предоставления и динамического управления Reporting Modes для Intrusion Detection System Manager (IdsM) [SWS_AIDSM_10600]. В сетевой архитектуре транспортного средства IdsM отслеживает события безопасности (Security Events). Через ReportingModeProvider приложения или ответственные платформенные службы могут обращаться к сконфигурированным событиям безопасности, чтобы выяснить или определить, каким способом событие должно передаваться в систему IdsM. Привязка к архитектуре осуществляется через смоделированный PPort, указываемый при инстанцировании [SWS_AIDSM_10601].

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

Класс объявлен как final [SWS_AIDSM_10600], что исключает наследование или полиморфную специализацию. Создание объекта осуществляется через явный конструктор ReportingModeProvider(const ara::core::InstanceSpecifier& instance) [SWS_AIDSM_10601]. Через параметр instance устанавливается привязка к конкретному смоделированному PPort [SWS_AIDSM_10601]. Интерпретация: переданное обозначение экземпляра при этом, предположительно, ссылается на развертывание интерфейса для службы IdsM, сконфигурированное в модели AUTOSAR. Вопрос Q-a7c5bdfa7e2ba42b (открытый)

Что касается многопоточности, конструктор специфицирован как потокобезопасный (thread-safe) [SWS_AIDSM_10601]. Оба оперативных метода для чтения и записи режимов отчетов, напротив, явно обозначены как непотокобезопасные (not thread-safe) [SWS_AIDSM_10602], [SWS_AIDSM_10603]. Если несколько потоков параллельно обращаются к одному и тому же экземпляру ReportingModeProvider, вызывающий компонент должен синхронизировать этот доступ извне. Жизненный цикл экземпляра обычно привязан ко времени жизни использующего его приложения, которое создает объект, управляет им и уничтожает после завершения взаимодействия.

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

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

Сначала приложение инстанцирует провайдер для предусмотренного порта с указанием соответствующего InstanceSpecifier [SWS_AIDSM_10601]. Затем с помощью метода GetReportingMode можно запросить текущий Reporting Mode для конкретного сконфигурированного события [SWS_AIDSM_10602]. Метод возвращает ara::core::Result<ReportingModeType>, инкапсулирующий режим или сигнализирующий о возникшей ошибке [SWS_AIDSM_10602].

Если ситуация с безопасностью или конфигурация диагностики требует модификации, вызывается SetReportingMode [SWS_AIDSM_10603]. Этот вызов принимает идентификатор eventId, а также новый reportingMode и возвращает ara::core::Result<void> [SWS_AIDSM_10603]. Приложение проверяет результат, чтобы убедиться в успешном завершении изменения конфигурации.

Диаграмма последовательности: типичный путь использования для запроса и обновления режима отчетов через провайдер. Источники: [SWS_AIDSM_10601], [SWS_AIDSM_10602], [SWS_AIDSM_10603]

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

Все методы класса объявлены с noexcept [SWS_AIDSM_10601], [SWS_AIDSM_10602], [SWS_AIDSM_10603]. Поэтому обработка ошибок выполняется полностью без исключений C++ через собственную модель ошибок AUTOSAR ara::core::Result.

Как при извлечении через GetReportingMode [SWS_AIDSM_10602], так и при установке через SetReportingMode [SWS_AIDSM_10603] предполагается, что переданный eventId соответствует сконфигурированному событию безопасности. Если передается неизвестный или не зарегистрированный в системе идентификатор события, операция завершается неудачно, и Result содержит код ошибки IdsmErrc::kUnknownEventId [SWS_AIDSM_10602], [SWS_AIDSM_10603]. Вызывающие компоненты должны проверять Result перед доступом к значению и в случае ошибки запускать соответствующую обработку ошибок или протоколирование.