结构体 ara::com::FindServiceHandle

结构体 ara::com::FindServiceHandle 用作唯一控制令牌，以控制在后台运行的服务监控 (AUTOSAR_AP_EXP_ARAComAPI 第34页)。由于默认构造函数已被删除 ([SWS_CM_00353])，该 Handle 仅由 StartFindService 创建，并在接收到异步状态回调后允许通过 StopFindService 定向终止搜索 (AUTOSAR_AP_EXP_ARAComAPI 第30页)。支持的比较运算符还确保了可以在标准容器中对多个搜索请求进行可存储的管理 ([SWS_CM_11526], [SWS_CM_11527])。

更多 ›

上下文

结构体 ara::com::FindServiceHandle 在 Adaptive Platform 的模块 com 中用作异步连续服务搜索的唯一标识符和控制令牌。通过 FindService 进行的同步查询是一次性确定匹配的服务实例并直接返回 Handle 容器，而 StartFindService 则在后台启动对服务可用性的持久监控 (AUTOSAR_AP_EXP_ARAComAPI 第34页)。该过程通常涉及应用程序实例、类型特定的 Proxy 类（例如 RadarServiceProxy）以及 FindServiceHandler 类型的用户自定义回调函数 (AUTOSAR_AP_EXP_ARAComAPI 第30页)。ara::com::FindServiceHandle 的具体内部表示针对各 Communication Management 进行实现特定的设计，但为操作提供了标准化的 C++ 接口。

生命周期

ara::com::FindServiceHandle 的生命周期与 Communication Management 中的活动搜索过程紧密绑定：

• 创建：默认构造函数已被显式删除 ([SWS_CM_00353])。因此，应用程序无法创建未初始化或随意的 Handle 实例。相反，有效的 Handle 仅作为 ara::core::Result 的有效负载由静态方法 StartFindService 生成 (AUTOSAR_AP_EXP_ARAComAPI 第30页)。
• 管理与所有权：Handle 支持通过拷贝赋值运算符 [SWS_CM_11528] 进行赋值。为了允许应用程序在标准容器（如有序集合或关联容器）中存储和组织多个搜索请求，该类型通过运算符 operator== ([SWS_CM_11526]) 和 operator< ([SWS_CM_11527]) 满足 C++ 概念 [equalitycomparable] 和 [lessthancomparable]。
• 终止与销毁：只要后台监控处于活动状态，Handle 就保持有效。通过将 Handle 传递给 StopFindService 来终止搜索 (AUTOSAR_AP_EXP_ARAComAPI 第30页, AUTOSAR_AP_EXP_ARAComAPI 第34页)。在此调用之后，Handle 不再表示正在运行的搜索过程。

使用路径

常规流程包括注册搜索请求、持续接收可用性更新以及有序停止监控过程：

1. 启动搜索：应用程序通过 StartFindService 注册一个 FindServiceHandler，以接收关于新可用或失效服务实例的通知 (AUTOSAR_AP_EXP_ARAComAPI 第30页, AUTOSAR_AP_EXP_ARAComAPI 第34页)。
2. 获取 Handle：成功启动后，该调用返回包含 FindServiceHandle 的 ara::core::Result (AUTOSAR_AP_EXP_ARAComAPI 第30页)，应用程序将其保存以供后续控制调用使用。
3. 异步通知：Communication Management 执行后台搜索，并在状态发生更改时调用所提供的处理程序 (AUTOSAR_AP_EXP_ARAComAPI 第34页)。
4. 停止搜索：一旦找到实例或不再需要监控，应用程序就会将 Handle 传递给 StopFindService (AUTOSAR_AP_EXP_ARAComAPI 第30页, AUTOSAR_AP_EXP_ARAComAPI 第34页)。

时序图：从注册、通知到通过 FindServiceHandle 终止的异步服务搜索典型流程。来源：AUTOSAR_AP_EXP_ARAComAPI 第30页, AUTOSAR_AP_EXP_ARAComAPI 第34页。

错误场景

在使用 ara::com::FindServiceHandle 时，需注意以下系统特定边界条件：

• 搜索启动失败：如果技术绑定不可用或服务部署配置错误 (AUTOSAR_AP_EXP_ARAComAPI 第34页)，则 StartFindService 失败。在这种情况下，返回的 ara::core::Result 不包含有效 Handle，而是包含错误码 (AUTOSAR_AP_EXP_ARAComAPI 第30页)。
• 异常安全性：实现的比较和赋值运算符 operator== ([SWS_CM_11526])、operator< ([SWS_CM_11527]) 和 operator= ([SWS_CM_11528]) 在规范中被显式声明为非异常安全 (not exception safe)。
• 多次停止：使用同一个 Handle 重复调用 StopFindService 可能会无效果或导致运行时错误，因为底层的监控活动已被移除。 问题 Q-f44130c33fa1caea (未决)