类 ara::idsm::EventReporter

类 EventReporter 在头文件 ara/idsm/event_reporter.h 中定义，在 Adaptive Platform 中用于向 Intrusion Detection System Manager（IdsM）报告安全相关事件（Security Events）[SWS_AIDSM_10101]。

使用与实例化

要使用该类，必须通过接收类型为 const ara::core::InstanceSpecifier& 的标识符的有参构造函数来创建实例 [SWS_AIDSM_10301]。该构造函数会为系统模型中配置的类型为 SecurityEventReportInterface 的端口初始化报告器 [SWS_AIDSM_10301]。Interpretation：与建模端口的绑定推测需要传入的 InstanceSpecifier 在 ARXML 清单中有一致的定义，并且在运行时可解析。 问题 Q-ed2f606f7446b4ba (未决)

错误处理与并发

关于异常行为，构造被指定为带有 noexcept [SWS_AIDSM_10301]；因此该构造函数不抛出 C++ 异常。关于并发性，构造函数被显式声明为线程安全 [SWS_AIDSM_10301]。Interpretation：因此，多个线程推测可以为它们各自的端口并行实例化报告器实例，而无需外部同步机制。 问题 Q-ddff9884a7b7cad8 (未决)

相互作用

与 IdsM 的交互基于实例与相应建模端口的关联：通过指定为 SecurityEventReportInterface [SWS_AIDSM_10301] 的 EventReporter，该类构成了自适应应用程序向 IdsM 架构传输安全事件的接口 [SWS_AIDSM_10101]。

使用

来自头文件 ara/idsm/event_reporter.h 的函数 ReportEvent 用于报告带有上下文数据的安全事件 [SWS_AIDSM_10304]。在调用时会传递类型为 ContextDataType 的实参 contextData。此外，还可以通过 count（类型 CountType）可选指定事件数量，其默认值设定为 1 [SWS_AIDSM_10304]。该函数不提供返回值（void），且作为 noexcept 声明不抛出异常。

并发性与限制

该接口被明确定义为 thread-safe [SWS_AIDSM_10304]，可以在没有额外同步措施的情况下从多个线程并行调用。由于签名未提供时间戳参数，因此报告时间的记录推测大概率在内部接收事件时进行。 问题 Q-ab652343cc8009e9 (未决)

与相关接口的交互

该规范为不同的信息范围定义了 ReportEvent 的多个相关重载：

• 报告不带上下文数据和时间戳的事件 [SWS_AIDSM_10302]。
• 带有时间戳但不带上下文数据的报告 [SWS_AIDSM_10303]。
• 带有上下文数据和显式时间戳的报告 [SWS_AIDSM_10305]。
• 带有类型为 VersionedContextDataType 的版本化上下文数据的报告，要么不带时间戳 [SWS_AIDSM_10306]，要么带有时间戳 [SWS_AIDSM_10307]。

使用

函数 [SWS_AIDSM_10305] 传输带有应用特定上下文数据以及显式时间戳的安全事件。通过类型为 ContextDataType 的实参 contextData 传递与事件相关的有效负载数据，而 timestamp（类型 const TimestampType）记录精确的捕获时间点。可选参数 count（类型 const CountType）的默认值为 1，允许报告多个累积发生的情况。该函数不提供返回值（void）。

并发与错误处理

声明位于头文件 ara/idsm/event_reporter.h 中，并明确指定为线程安全（thread-safe）[SWS_AIDSM_10305]。因此，可以从并行线程进行调用而无需额外的同步。通过带有 noexcept 标记，在 API 级别不会传播异常；因此在转发或缓冲时的任何错误都推测由 Intrusion Detection System Manager 在内部进行处理。 问题 Q-3b45e18c9a106a0f (未决)

交互与替代方案

该接口属于一组重载的报告函数。如果不需要上下文数据或时间戳，可以使用更轻量的变体，例如 [SWS_AIDSM_10302]（仅计数器）、[SWS_AIDSM_10303]（带时间戳）以及 [SWS_AIDSM_10304]（仅带上下文数据）。如果需要结构化或版本化的数据格式，则应改用符合 [SWS_AIDSM_10306] 和 [SWS_AIDSM_10307] 的带有 VersionedContextDataType 的重载。

函数 ReportEvent 在模块 aidsm 中提供了一个用于报告附带版本化上下文数据的安全事件的接口 [SWS_AIDSM_10306]。它在头文件 ara/idsm/event_reporter.h 中定义，且不提供返回值（void）。

调用时处理以下参数：

• contextData（类型 VersionedContextDataType）：传递所发生安全事件的版本化上下文信息 [SWS_AIDSM_10306]。
• count（类型 const CountType，默认值 1）：可选地确定该事件累积发生的次数 [SWS_AIDSM_10306]。

关于并发性，该函数被指定为线程安全（thread-safe）[SWS_AIDSM_10306]。通过使用 noexcept 声明，确保了执行不会抛出 C++ 异常。

在与其他报告函数的交互中，该重载涵盖了一个特定的用例：

• 对于不带上下文数据的报告，提供了不带时间戳的变体 [SWS_AIDSM_10302] 或带有时间戳的变体 [SWS_AIDSM_10303]。
• 对于未版本化的上下文数据（ContextDataType），存在不带时间戳的重载 [SWS_AIDSM_10304] 以及带有时间戳的重载 [SWS_AIDSM_10305]。
• 如果要将版本化的上下文数据与显式时间戳一起传输，则应改用 [SWS_AIDSM_10307]。解释：由于 [SWS_AIDSM_10306] 没有时间戳参数，捕获时间点大概率在执行调用时由内部生成。 问题 Q-23e60086ab409b24 (未决)

用法与调用上下文

来自头文件 ara/idsm/event_reporter.h 的函数 ReportEvent 用于报告带有显式版本化上下文数据以及时间戳的安全事件 [SWS_AIDSM_10307]。它接收类型为 VersionedContextDataType 的版本化数据 contextData、类型为 TimestampType 的时间戳 timestamp 以及可选的类型为 CountType 的事件计数 count，该事件计数默认预设为值 1 [SWS_AIDSM_10307]。

并发与错误处理

该函数被明确指定为 thread-safe [SWS_AIDSM_10307]，因此可以安全地从多个线程并行调用。由于签名未规定返回值（void）且声明为 noexcept [SWS_AIDSM_10307]，因此错误既不会通过 C++ 异常也不会通过状态码来指示；解释：事件传输中的错误情况大概率由模块 aidsm 在内部处理或记录。 问题 Q-002c5fbc3202bcc2 (未决)

重载之间的交互

该函数代表针对同时产生时间戳和版本化附加数据的事件的专用变体 [SWS_AIDSM_10307]。它补充了报告器中 ReportEvent 的其他重载：

• 不带上下文数据和时间戳的报告 [SWS_AIDSM_10302] 或仅带时间戳的报告 [SWS_AIDSM_10303]。
• 带有未版本化上下文数据且不带时间戳的报告 [SWS_AIDSM_10304] 以及带有时间戳的报告 [SWS_AIDSM_10305]。
• 带有版本化上下文数据且不带时间戳的报告 [SWS_AIDSM_10306]。

使用

函数 ReportEvent 通过头文件 ara/idsm/event_reporter.h 提供，用于报告不带上下文数据和时间戳的安全事件 [SWS_AIDSM_10302]。它接受类型为 CountType 的事件计数 count 作为参数，该参数默认预设为值 1 [SWS_AIDSM_10302]。该函数没有返回值（void），并通过标记 noexcept 保证不抛出异常 [SWS_AIDSM_10302]。关于执行语义，由于未指定同步状态或异步 Future 返回类型，内部处理大概率以非阻塞方式进行。 问题 Q-6e240ebde61d8a83 (未决)

并发与错误处理

根据规范，该调用被归类为 thread-safe，因此可以从并发线程安全调用 [SWS_AIDSM_10302]。由于签名被固定为 void 和 noexcept，因此不存在特定的错误码 [SWS_AIDSM_10302]。

交互与替代方案

该函数代表了用于事件报告的最简单重载。如果需要传输扩展信息，可以使用相关的重载：

• 通过 TimestampType 带有时间戳的报告 [SWS_AIDSM_10303]。
• 通过 ContextDataType 带有常规上下文数据的报告 [SWS_AIDSM_10304]，以及结合时间戳的报告 [SWS_AIDSM_10305]。
• 通过 VersionedContextDataType 带有版本化上下文数据的报告 [SWS_AIDSM_10306]，以及结合时间戳的报告 [SWS_AIDSM_10307]。

函数 ReportEvent 用于在显式指定时间戳的情况下报告安全事件 [SWS_AIDSM_10303]。它在头文件 ara/idsm/event_reporter.h 中声明 [SWS_AIDSM_10303]。

使用

该调用使用类型为 TimestampType 的必选参数 timestamp 以及类型为 CountType 的可选计数器 count 进行，该计数器预设了默认值 1 [SWS_AIDSM_10303]。该函数没有返回值（void）[SWS_AIDSM_10303]。

错误处理与并发

该函数被声明为 noexcept，因此不会出现 C++ 异常 [SWS_AIDSM_10303]。由于返回类型为 void，因此不会传输错误码；发生的错误大概率在内部被丢弃或进行异步记录 [SWS_AIDSM_10303]。 问题 Q-2d3cd862f6867ba9 (未决)在并发性方面，该函数被归类为 thread-safe，可以安全地从并行线程调用 [SWS_AIDSM_10303]。

相互作用

该函数是 aidsm 模块中重载的 ReportEvent 接口族的一部分：

• 不带时间戳且不带上下文数据时，可以使用基础函数 [SWS_AIDSM_10302]。
• 带有类型为 ContextDataType 的常规上下文数据时，存在不带时间戳的重载 [SWS_AIDSM_10304] 以及带有时间戳的重载 [SWS_AIDSM_10305]。
• 带有类型为 VersionedContextDataType 的版本化上下文数据时，提供了对应的不带时间戳签名 [SWS_AIDSM_10306] 和带有时间戳签名 [SWS_AIDSM_10307]。