类 ara::com::ComErrorDomain

类 ara::com::ComErrorDomain 表示通信错误域，用于标识 ara::com API 中的通用、非接口特定错误（[SWS_CM_11265]）。它为诸如 ComErrc::kCommunicationFailure 之类的错误代码提供错误描述，并允许通过 Message() 查询这些描述或通过 ThrowAsException() 将其转换为异常（[SWS_CM_11332]）。由于其默认构造函数已被删除，因此它充当承载错误 ara::core::Result 的无状态、线程安全域实例。

更多 ›

上下文

类 ara::com::ComErrorDomain 表示 Adaptive Platform 针对功能集群 Communication Management 的标准化通信错误域（SWS CommunicationManagement 第439页）。它派生自基类 ara::core::ErrorDomain，并定义了在方法调用或数据传输过程中可能发生但非单个 ServiceInterface 特有的通用错误的语义上下文（[SWS_CM_11265]）。在 ara::com 的错误架构中，它将常规通信故障与 E2E 监控错误以及应用程序特定的服务错误进行系统性区分（SWS CommunicationManagement §7.5.22.6 “Error Related Data Types”）。

其核心交互伙伴包括 Adaptive Application、中间件的服务和代理实现以及基础系统的 ara::core::ErrorCode 和 ara::core::Result 数据类型（EXP ARAComAPI §4.7 “Error Handling”）。对于语义类型绑定，该类为错误代码枚举 ComErrc 提供类型别名 Errc（[SWS_CM_11336]），并为相应的异常类 ComException 提供类型别名 Exception（[SWS_CM_11337]）。

上下文图：ComErrorDomain 在 ara::com 错误架构中的归属。来源：[SWS_CM_11265]、EXP ARAComAPI §4.7 “Error Handling”、SWS CommunicationManagement §7.5.22.6 “Error Related Data Types”

生命周期

作为错误域的规范类，ara::com::ComErrorDomain 通过删除默认构造函数 ComErrorDomain() = delete; 来阻止其实例创建（[SWS_CM_11330]）。解释：域实例的提供可能通过平台作为静态单例进行，因此应用程序组件无需动态实例化或管理该域。 问题 Q-bf957a108c0a5378 (未决)

该实例充当无状态描述符，不包含可变属性。所有提供的方法（例如 Name()（[SWS_CM_11331]）和 Message()（[SWS_CM_11332]））均被声明为 const noexcept。这确保了在并行应用程序和中间件线程进行并发错误查询时具有完全的线程安全性。

使用路径

典型的使用路径包括通过 ara::com 的接口检测、传输和评估错误：

1. 应用程序发起服务交互，例如通过方法类 operator() 的调用运算符（[SWS_CM_00196]）。
2. 如果中间件在处理过程中检测到错误情况（例如通信故障或未配置的应用程序错误 [SWS_CM_00048]），则会在相应的 Promise 上调用操作 SetError（SWS CommunicationManagement 第300页）。
3. 此时构造一个 ara::core::ErrorCode，其域设置为 ara::com::ComErrorDomain（[SWS_CM_11329]），其数值代码设置为特定的枚举值（例如 ComErrc::kCommunicationFailure）（[SWS_CM_10432]）。
4. 返回给应用程序的 ara::core::Future 或 ara::core::Result 在错误状态下将错误代码传递给调用者（EXP ARAComAPI §4.7 “Error Handling”）。
5. 应用程序检查 Result 并利用域函数 Name()（[SWS_CM_11331]）和 Message()（[SWS_CM_11332]）来解析用于记录或诊断的错误消息。
6. 如果应用程序逻辑需要异常且已启用 C++ 异常，则可以通过 ThrowAsException() 触发转换为 ComException（[SWS_CM_11333]）。

时序图：通过 ComErrorDomain 发出通信错误信号并进行查询。来源：[SWS_CM_00196]、[SWS_CM_10432]、[SWS_CM_11329]、[SWS_CM_11332]、SWS CommunicationManagement 第300页

错误场景

ara::com 的错误概念严格区分可恢复错误（Recoverable Errors）与严重编程违规（Violations 或 Corruptions）（EXP ARAComAPI §4.7 “Error Handling”）。可恢复错误通过 ara::core::Result 和 ara::core::ErrorCode 处理，其中域 ComErrorDomain 的错误代码通过标识符别名 Errc 进行寻址（[SWS_CM_11336]）。

例如，如果在远程调用期间发生传输中断，系统将报告 ComErrc::kCommunicationFailure（[SWS_CM_10432]）。在出现未配置的应用程序错误时，中间件将中止调用，并同样设置该域的相应错误代码（[SWS_CM_00048]、SWS CommunicationManagement 第300页）。

如果要将错误代码作为异常抛出，ThrowAsException() 将实例化类型为 ComException 的异常（[SWS_CM_11337]）并将其抛出（[SWS_CM_11333]）。该方法不是异常安全的（not exception safe），并且根据规范，在禁用 C++ 异常时不参与重载解析（[SWS_CM_11333]）。相反，不可恢复的系统违规将直接导致平台中止，并且不通过 ComErrorDomain 处理（EXP ARAComAPI §4.7 “Error Handling”）。