类 ara::idsm::ReportingModeProvider

类 ara::idsm::ReportingModeProvider 提供了用于在 Intrusion Detection System Manager 中查询和设置安全相关事件的 Reporting Mode 的机制 [SWS_AIDSM_10600]。实例化通过针对建模的 PPort [SWS_AIDSM_10601] 的 ara::core::InstanceSpecifier 以线程安全的方式进行。在运行时，方法 GetReportingMode 和 SetReportingMode 允许读取和修改已配置事件的模式。由于这些方法不是线程安全的，因此并发访问必须由外部进行同步。在事件 ID 未知时，这些方法将返回错误 IdsmErrc::kUnknownEventId。

更多 ›

上下文

类 ara::idsm::ReportingModeProvider 在头文件 ara/idsm/reporting_mode_provider.h 中定义，用于在 Adaptive 模块 idsm 内部为 Intrusion Detection System Manager (IdsM) 提供并动态控制 Reporting Mode [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]。解释：传入的实例标识可能指向 AUTOSAR 模型中为 IdsM 服务配置的接口部署。 问题 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，并在出错时启动相应的错误处理或记录。