类 ara::com::ComException

类 ara::com::ComException 在 AUTOSAR Adaptive 中用作核心异常类，用于在调用通信 API 时发出错误信号 [SWS_CM_11327]。它封装了一个 ara::core::ErrorCode，在操作失败时被实例化并抛出，其构造函数被定义为异常安全且不抛出异常 [SWS_CM_11328]。如果在编译器工具链中禁用了 C++ 异常，则相应的抛出异常的 API 重载将完全从重载解析中排除。调用方捕获该异常对象以分析所包含的错误码并采取错误处理措施。

更多 ›

上下文

类 ara::com::ComException 在 AUTOSAR Adaptive Platform 的 com 模块中用作专用异常类，用于在调用通信 API 时发出错误信号 [SWS_CM_11327]。它公有继承自基类 ara::core::Exception 并被声明为 final。这表明其直接集成了 Adaptive Platform 的全局错误处理架构。通过标记为 final，推测该类被设计为密封异常类型，不用于进一步的派生层次结构。 问题 Q-2454b5b73295287b (未决)

ara::com::ComException 的主要任务是将发生的错误状态以 ara::core::ErrorCode 的形式进行封装，并通过 C++ 异常机制传递给调用层 [SWS_CM_11328]。声明和定义通过头文件 #include "ara/com/com_error_domain.h" 提供 [SWS_CM_11328]。核心交互伙伴包括使用它的应用软件、通信管理的内部服务与 API 函数以及错误域类型 ara::core::ErrorCode。

生命周期

ara::com::ComException 对象的生命周期始于通信管理 API 函数的实现中，一旦操作失败，便会实例化并触发该异常 AUTOSAR_AP_SWS_CommunicationManagement §8.12.5 “Class: ComException”。其创建通过显式构造函数进行，该构造函数接管触发异常的 ara::core::ErrorCode 对象 [SWS_CM_11328]。

该构造函数声明为 noexcept 并具有属性 exception safe [SWS_CM_11328]。这确保了在构造异常对象本身的过程中不会发生进一步的异常。通过 throw 抛出后，该对象在栈展开过程中传递，直到绑定在调用层的相应 catch 块中。关于所有权关系，实例在离开处理块后会自动在栈上销毁。该类不包含状态机意义上的内部状态转换；其状态在使用错误码初始化后保持不可变。

使用路径

典型使用路径描述了错误检测、异常触发及后续处理的流程：

1. 应用函数调用 ara::com 接口的操作。
2. 如果处理过程中发生错误，API 实现会从相应的 errorCode 创建 ara::com::ComException 的新实例并将其抛出 AUTOSAR_AP_SWS_CommunicationManagement §8.12.5 “Class: ComException”。
3. 应用程序在相应的块中捕获异常。应用端推测通过常量引用（const ara::com::ComException&）进行捕获，以避免复制操作。 问题 Q-5270e026eeac8be7 (未决)
4. 调用方通过基类接口访问所包含的 ara::core::ErrorCode，并执行诊断或补偿步骤 [SWS_CM_11328]。

时序图：ara::com::ComException 的错误检测、实例化和处理流程。来源：[SWS_CM_11327]，[SWS_CM_11328]，AUTOSAR_AP_SWS_CommunicationManagement §8.12.5 “Class: ComException”

错误场景

在错误处理和工具链配置上下文中，以下条件和边界情况适用：

• 已禁用 C++ 异常：如果编译器工具链中禁用了 C++ 异常，则根据 [SWS_CORE_10304]，创建并抛出 ara::com::ComException 的 API 函数将不参与重载解析 AUTOSAR_AP_SWS_CommunicationManagement §8.12.5 “Class: ComException”。在这种情况下，执行错误处理的软件将改用备选返回机制。
• 构造函数类型安全性：由于构造函数声明为 explicit，因此在传递 ara::core::ErrorCode 时会阻止隐式类型转换 [SWS_CM_11328]。
• 分层捕获：由于 ara::com::ComException 继承自 ara::core::Exception，调用方既可以将其作为 ara::com::ComException 进行专门处理，也可以通过基类的处理器进行常规处理。