类 ara::shwa::CpuSelector

类 ara::shwa::CpuSelector 在模块 shwa 中用于根据特定选择器策略评估和针对性选择硬件设备 [AP_SWS_SHWA_00410]。应用程序软件可以通过 operator() 评估单个候选设备，或者通过方法 SelectDevice() 直接确定合适的首选设备 [AP_SWS_SHWA_00409]。作为重要边界条件，这些接口被规范为非线程安全，不提供回滚语义，且仅通过 ara::core::Result 传递资源占用等潜在错误。

更多 ›

上下文

类 ara::shwa::CpuSelector 是 AUTOSAR Adaptive Platform 内硬件加速模块（shwa）的组成部分。它派生自基接口 DeviceSelector，并特化了执行设备的功能选择。其主要职责在于根据选择器策略评估硬件设备（Device）或直接选择合适的设备 [AP_SWS_SHWA_00409]，[AP_SWS_SHWA_00410]。

在整个系统中，CpuSelector充当请求软件组件与可用硬件单元之间的纽带。虽然DeviceSelector提供通用接口，但正如类名所示，CpuSelector作为选择器策略应专门针对基于CPU的硬件资源。 问题 Q-32abbae13e272c68 (未决)应用软件集成此类，以便在移交工作之前就资源适用性做出明智的决策。

生命周期

CpuSelector的实例在应用上下文中或由上级管理实例创建，以提供选择策略。核心评估与选择操作被声明为const，因此该实例在其使用期间对外表现为无状态，且不修改任何内部选择状态[AP_SWS_SHWA_00409]、[AP_SWS_SHWA_00410]。

就并发性而言，SelectDevice() [AP_SWS_SHWA_00410]和operator() [AP_SWS_SHWA_00409]都不是线程安全的（not thread-safe）。由于这些方法被指定为非线程安全，因此对同一CpuSelector实例的并发访问推测必须由调用方进行同步。 问题 Q-fced1ce242dea2c2 (未决)在生命周期结束时，该选择器无需专门的回滚程序即可销毁。

使用路径

与CpuSelector的典型交互包括单独评估各个候选对象，或直接查询最佳目标设备。为了进行候选对象检查，调用方将设备引用传递给operator()(const Device &device) [AP_SWS_SHWA_00409]。作为ara::core::Result<int>返回的operator()应表示所传递Device的数值评估指标（分数），可据此比较多个设备。 问题 Q-33885b34ba761592 (未决)

如果应用程序希望将选择完全交由策略处理，则调用SelectDevice() [AP_SWS_SHWA_00410]。该方法在内部确定合适的设备，并返回封装有所选目标设备的ara::core::Result<Device>。

时序图：通过CpuSelector评估和选择目标设备的典型流程。来源：[AP_SWS_SHWA_00409]、[AP_SWS_SHWA_00410]。

错误场景

这两种方法均声明为noexcept，并保证完全的异常安全性（exception safe）[AP_SWS_SHWA_00409]、[AP_SWS_SHWA_00410]。发生的错误条件不通过C++异常报告，而是通过ara::core::Result中的错误域返回。

针对这两种方法指定了来自ShwaErrorCode的以下错误值：

• ShwaErrorCode::kResourceBusy：未能执行求值或选择，因为所寻址的资源当前正处于忙碌状态[AP_SWS_SHWA_00409]、[AP_SWS_SHWA_00410]。
• ShwaErrorCode::kFeatureNotSupported：请求的设备属性或选择器功能不受系统支持[AP_SWS_SHWA_00409]、[AP_SWS_SHWA_00410]。

作为operator()的前置条件，必须提供有效的Device引用。两个函数均不采用回滚语义（no_rollback_semantics），因此在发生错误时不会自动清理先前的系统状态[AP_SWS_SHWA_00409]、[AP_SWS_SHWA_00410]。