类 ara::com::e2e::ComE2EException

类 ara::com::e2e::ComE2EException 用作标准化 C++ 异常，用于报告来自通信管理（[SWS_CM_12501]）E2E API 的错误。它继承自 ara::core::Exception 并封装了一个特定的 ara::core::ErrorCode，该错误码在实例化时通过异常安全的 noexcept 构造函数传入（[SWS_CM_12502]）。如果编译器工具链中禁用了 C++ 异常，根据规范，触发函数将不参与重载解析，因此该错误路径以活动的异常支持为前提。

更多 ›

上下文

类 ara::com::e2e::ComE2EException 用作标准化 C++ 异常类，由通信管理中的端到端（E2E）API 触发，以发出发生错误条件的信号（[SWS_CM_12501]，AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”）。该类声明为 final 并公有继承自 ara::core::Exception（AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”）。它通过头文件 ara/com/e2e/e2e_error_domain.h 提供（[SWS_CM_12502]）。

在 AUTOSAR Adaptive 的功能架构内，ComE2EException 充当平台的 E2E 监控例程与调用应用软件之间的通信桥梁。如果 E2E 函数在检查或处理数据时检测到错误状态，该错误将通过抛出此异常传递给上层控制流（AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”）。

生命周期

ComE2EException 对象的实例化通过将错误码显式传递给构造函数 explicit ComE2EException(ara::core::ErrorCode errorCode) noexcept 进行（[SWS_CM_12502]，AUTOSAR_AP_SWS_CommunicationManagement §8.15.4.1.1.1 “ComE2EException”）。构造函数被指定为 noexcept 且异常安全（exception safe）（[SWS_CM_12502]）。这保证了在构造异常本身时不会抛出其他异常，从而确保了错误路径中的鲁棒性。

在所有权关系方面，异常由触发的 E2E 接口创建并通过值抛出（AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”）。应用端通常将其作为常量引用捕获。一旦离开相应的处理块，就会在常规 C++ 栈展开过程中自动销毁。由于该类被定义为 final，因此未设计子类。

使用路径

使用该异常的典型流程分为以下阶段：

• 应用软件调用通信管理的受 E2E 保护的函数。
• E2E 逻辑在数据处理或检查时检测到错误，使用特定 errorCode 实例化 ara::com::e2e::ComE2EException 的实例并将其抛出（AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”）。
• 应用程序在 try-catch 块中捕获异常。调用方在此推测（解读）访问 ara::core::Exception 的继承基类方法，以评估包含的 ara::core::ErrorCode 进行故障诊断。 问题 Q-8dfac2428f223afe (未决)

时序图：发生 E2E 错误时通过 ComE2EException 进行错误处理的流程。来源：[SWS_CM_12501]，[SWS_CM_12502]，AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”。

错误场景

对于 ComE2EException 的使用，在工具链方面存在一项重要前提条件：根据 [SWS_CORE_10304]，若编译器中禁用了 C++ 异常，则创建并抛出该实例的函数不参与重载解析（overload resolution）（AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”）。因此，在没有 C++ 异常支持的运行时环境中，该信号路径不存在；在此情况下，错误推测（解读）通过平台的备选非异常错误机制进行传递。 问题 Q-e1b3f4f1dfc191ef (未决)

只要启用了异常，每个 ComE2EException 都必须强制携带一个错误码（[SWS_CM_12502]）。作为实例化的前提条件，必须有有效的 ara::core::ErrorCode 可用（[SWS_CM_12502]）。由于构造函数声明为异常安全（[SWS_CM_12502]），因此即使在错误情况下，对象创建本身也不会失败。