类 ara::shwa::DeviceSelector

抽象类 ara::shwa::DeviceSelector 定义了一个策略接口，用于在子系统 shwa 中评估和选择目标设备。它允许通过 SelectDevice() 直接确定最佳设备，并通过 operator() 对各个候选设备进行比较评估 [AP_SWS_SHWA_00403]、[AP_SWS_SHWA_00404]。虚默认析构函数保证了派生策略实例的安全销毁。关键约束条件包括调用不是线程安全的，并且在发生故障时不适用自动回滚语义。

更多 ›

上下文

类 ara::shwa::DeviceSelector 在模块 shwa 中提供了一个抽象接口，用于基于特定选择策略选择或评估硬件或功能设备（Device）。它充当上层控制应用程序与具体选择过程之间的解耦层。参与的交互对象包括调用方应用程序、选择策略的具体实现以及 Device 类型的目标对象。该接口定义了两个核心操作：通过 SelectDevice() [AP_SWS_SHWA_00403] 直接选择设备，以及通过函数调用运算符 operator() [AP_SWS_SHWA_00404] 对设备进行比较性单独评估。

上下文图：DeviceSelector 在应用程序与设备目标之间的嵌入。来源：[AP_SWS_SHWA_00403]、[AP_SWS_SHWA_00404]

生命周期

作为包含纯虚方法的抽象基类，DeviceSelector 无法直接实例化。具体的选择策略应该实现为派生类并由应用程序组件创建。 问题 Q-4e22b2e57ef141e9 (未决)所有权管理通常由应用程序负责，例如通过智能指针如 std::unique_ptr<DeviceSelector>。为了对特化类进行彻底的多态销毁，该接口声明了一个虚默认析构函数 ~DeviceSelector() [AP_SWS_SHWA_00402]。该析构函数显式声明为 noexcept，从而在销毁实例时满足异常安全性（exception safe）要求 [AP_SWS_SHWA_00402]。

在并发性和状态转换方面，接口操作被归类为非线程安全（not thread-safe）[AP_SWS_SHWA_00403]、[AP_SWS_SHWA_00404]。尽管成员函数带有 const 注解，但在没有外部同步的情况下，不得从不同线程对同一实例进行并发访问。此外，规范未对失败的调用规定自动回滚机制（no_rollback_semantics）[AP_SWS_SHWA_00403]、[AP_SWS_SHWA_00404]。

使用路径

典型的使用流程包括初始化具体策略实例，然后对候选设备进行评估或选择。这里存在两条主要调用路径：

• 直接设备选择：应用程序调用无参数方法 SelectDevice() [AP_SWS_SHWA_00403]。具体策略自主确定最合适的设备并返回 ara::core::Result<Device>。
• 迭代式单独评估：在用于过滤或排序多个候选设备的算法中，应用程序将各个实例相继传递给 operator()(const Device &device) [AP_SWS_SHWA_00404]。通过 operator() 进行的求值应该在内部分析所传递设备的相关属性或操作状态。 问题 Q-8ba0b9b900196d50 (未决)在 ara::core::Result<int> 中返回的 int 值在此应该反映适用性指标或优先级，调用方据此做出选择决策。

时序图：用于单独评估和直接选择的调用序列，包括错误处理。来源：[AP_SWS_SHWA_00403]、[AP_SWS_SHWA_00404]

错误场景

两种选择方法均声明为 noexcept，且不抛出 C++ 异常（exception safe）。相反，它们通过 ara::core::Result 的错误通道发出失败信号。应用程序必须始终在访问结果之前检查返回值是否存在错误。为 SelectDevice() 和 operator() 定义了以下错误状态：

• ShwaErrorCode::kResourceBusy：由于所需资源当前被占用，无法执行请求的操作 [AP_SWS_SHWA_00403]、[AP_SWS_SHWA_00404]。在这种情况下，应用程序可以在稍后时间重试调用或选择替代策略。
• ShwaErrorCode::kFeatureNotSupported：如果底层实现不支持选择或评估所请求的功能，则返回该错误 [AP_SWS_SHWA_00403]、[AP_SWS_SHWA_00404]。

由于不存在回滚语义（no_rollback_semantics）[AP_SWS_SHWA_00403]、[AP_SWS_SHWA_00404]，发生错误时系统将保持在当前状态，调用方负责采取适当的补偿措施。此外，operator() 的先决条件是所传递的设备引用必须在整个调用期间保持有效。