类 ara::idsm::QualifiedEventsReceiver

类 QualifiedEventsReceiver 用于在头文件 ara/idsm/qualified_events_receiver.h 的上下文中从 Intrusion Detection System Manager（IdsM）接收限定的 Security Events [SWS_AIDSM_10800]。

使用与实例化：通过构造函数 QualifiedEventsReceiver(const ara::core::InstanceSpecifier& instance) 为建模的 PPort 创建实例 [SWS_AIDSM_10801]。该类模型强制使用移动语义：复制构造函数 [SWS_AIDSM_10804] 和复制赋值运算符 [SWS_AIDSM_10806] 已被删除（= delete）。实例可以改为通过移动构造函数 [SWS_AIDSM_10803] 或移动赋值 [SWS_AIDSM_10805] 进行转移。

并发性与线程安全：通过有参构造函数 [SWS_AIDSM_10801] 创建实例以及使用移动构造函数 [SWS_AIDSM_10803] 进行移动被指定为线程安全。相比之下，通过虚析构函数 [SWS_AIDSM_10802] 进行销毁以及通过 operator= [SWS_AIDSM_10805] 进行移动赋值被定义为非线程安全（not thread-safe）。因此，调用方必须确保不会在同一对象上并发执行赋值和销毁操作。

错误处理：所有指定的生命周期和赋值函数——构造函数、析构函数和移动赋值——均标有 noexcept，因此不会触发异常。

来自头文件 ara/idsm/qualified_events_receiver.h 的同步方法 Offer() 在调用时不带传入参数，用于指示对已限定安全事件的接收就绪状态 [SWS_AIDSM_10808]。成功调用后，允许 Intrusion Detection System Manager (IdsM) 随后通过回调方法 OnEventQualification 将已限定事件传输到该实例 [SWS_AIDSM_10808]。

签名使用 noexcept 声明了该函数，因此不会发生 C++ 异常，并提供 ara::core::Result<void> 作为返回类型 [SWS_AIDSM_10808]。由于规范未列出特定的错误代码，结果中传递的错误大概率指示在 IdsM 中的提供操作失败。 问题 Q-2eca6bb6ce27ec78 (未决)在并发性方面，该操作明确被指定为非线程安全（not thread-safe）[SWS_AIDSM_10808]。因此，调用方必须确保对 Offer() 的调用不会在未受保护的情况下与该实例的其他方法并行执行。

提供模式对应于模块 aidsm 中的标准化交互，其中服务提供者主动为 IdsM 启用其服务：

• 在头文件 ara/idsm/timestamp_provider.h 中，函数 Offer() 激活时间戳的提供，并使 IdsM 能够调用 GetTimestamp [SWS_AIDSM_10408]。
• 在头文件 ara/idsm/context_data_provider.h 中，Offer() 通过允许 IdsM 调用 ModifyContextData 来启用上下文数据的修改 [SWS_AIDSM_10507]。

纯虚函数 OnEventQualification 在头文件 ara/idsm/qualified_events_receiver.h 中定义，并用作用于接收具有未版本化上下文数据的合格安全事件（QSEv）的抽象回调 [SWS_AIDSM_10807]。

用法与参数：该方法在合格事件到达时由 Intrusion Detection System Manager（IdsM）调用。它声明以下接口参数 [SWS_AIDSM_10807]：

• event（EventIdType）：合格事件的唯一标识符。
• contextData（ara::core::Optional<ContextDataType>）：事件的可选未版本化上下文数据。
• timestamp（ara::core::Optional<TimestampType>）：事件发生的可选时间戳。

该方法没有返回值（void）且不抛出异常（noexcept）[SWS_AIDSM_10807]。

并发：该回调方法被规范为非线程安全（not thread-safe）[SWS_AIDSM_10807]。因此，应用程序侧实现必须确保对并发调用或访问进行同步。

生命周期与交互：IdsM 对 OnEventQualification 的调用是状态相关的：它们仅在通过 Offer 激活后才被允许 [SWS_AIDSM_10808]，并通过 StopOffer 被禁止 [SWS_AIDSM_10809]。对于带有版本化上下文数据或无上下文数据的事件，存在带有 VersionedContextDataType 的 OnEventQualification 的独立重载 [SWS_AIDSM_10810]。

使用

纯虚成员函数 OnEventQualification 用作应用程序特定的回调，用于通知带有版本化上下文数据或无上下文数据的合格安全事件（QSEv）[SWS_AIDSM_10810]。该函数声明以下传递参数：

• event（EventIdType）：合格事件的标识符 [SWS_AIDSM_10810]。
• contextData（ara::core::Optional<VersionedContextDataType>）：事件的可选版本化上下文数据 [SWS_AIDSM_10810]。
• timestamp（ara::core::Optional<TimestampType>）：事件的可选时间戳 [SWS_AIDSM_10810]。

该函数不返回值（void），并使用说明符 noexcept 进行声明 [SWS_AIDSM_10810]。

交互和生命周期

为了使 IdsM 能够执行对 OnEventQualification 的调用，接收方必须预先通过 Offer 激活该接口 [SWS_AIDSM_10808]。通过 StopOffer，后续对回调函数的调用将再次被禁止 [SWS_AIDSM_10809]。当 SWS_AIDSM_10810 处理版本化上下文数据时，对于未版本化数据存在符合 [SWS_AIDSM_10807] 的替代签名。

并发与错误处理

该函数被规范为非线程安全（not thread-safe）[SWS_AIDSM_10810]。如果并发发生调用，IdsM 的调用实例或具体实现可能必须确保相应的同步。 问题 Q-6b9e9525b682ad70 (未决)由于签名被定义为 noexcept 且不返回错误代码，因此在回调实现内部不得逃逸任何异常 [SWS_AIDSM_10810]。

根据 [SWS_AIDSM_10809] 调用头文件 ara/idsm/qualified_events_receiver.h 中的函数 StopOffer，以终止提供已限定安全事件的接收器服务。通过同步调用确保 Intrusion Detection System Manager (IdsM) 随后不再将任何调用转发给回调方法 OnEventQualification。

关于使用和接口行为，适用以下属性：

• 签名与错误处理：该函数不接受任何参数，也没有返回值（void StopOffer() noexcept;）。由于它被声明为 noexcept，因此它不会抛出异常，也不会返回错误代码 [SWS_AIDSM_10809]。
• 并发性：该操作在规范中被显式声明为 not thread-safe [SWS_AIDSM_10809]。因此，调用组件必须确保对 StopOffer 的调用相对于对同一实例的其他访问进行外部同步。
• 调用上下文：在销毁实例之前，调用很可能适当地在有序关闭或注销事件接收器的过程中进行。 问题 Q-77dc1d3a09426bdf (未决)

该设计模式类似地存在于模块 aidsm 的其他服务提供者中。例如，头文件 ara/idsm/timestamp_provider.h 中的 StopOffer 终止 IdsM 随后对 GetTimestamp 的调用 [SWS_AIDSM_10409]，而 ara/idsm/context_data_provider.h 中的同名函数则阻止未来对 ModifyContextData 的调用 [SWS_AIDSM_10508]。这两个相关接口同样都实现为非线程安全。