类 ara::diag::DiagSovdException

类 ara::diag::DiagSovdException 用作面向服务的车辆诊断（SOVD，Service-Oriented Vehicle Diagnostics）的专用异常类型，并由 diag 模块中的诊断类引发以用于错误发信 [SWS_DM_01807]。它派生自 ara::core::Exception，并在错误情况下显式使用 ara::core::ErrorCode 进行实例化，以便通过 C++ 栈展开将错误信息传递到调用上下文 [SWS_DM_01808]。作为关键约束条件，构造函数被指定为 noexcept，从而在对象创建时确保完全的异常安全性以及线程安全性。

更多 ›

上下文

类 ara::diag::DiagSovdException 代表 AUTOSAR Adaptive Platform 的 Diagnostics 模块中面向服务的车辆诊断（SOVD）的核心异常类型（[SWS_DM_01807]、SWS Diagnostics §8.51.4 “Class: DiagSovdException”）。它由内部诊断类抛出，以指示在处理 SOVD 请求过程中的特定错误状态（[SWS_DM_01807]、SWS Diagnostics, 第69页）。

该类公有派生自常规基类异常 ara::core::Exception（[SWS_DM_01807]、SWS Diagnostics §8.51.4）。其直接交互对象包括模块 diag 的功能性诊断类（用于分析诊断请求并在出错时触发异常），以及必须捕获并处理此类异常的调用方应用软件。该类在头文件 ara/diag/diag_sovd_error_domain.h 中声明，以满足上层架构要求（[SWS_DM_01808]、SWS Diagnostics §8.51.4.1.1.1 “DiagSovdException”）。

生命周期

ara::diag::DiagSovdException 的实例化通过一个强制接收 ara::core::ErrorCode 作为参数 err 的构造函数进行（[SWS_DM_01808]、SWS Diagnostics §8.51.4.1.1.1）。该构造函数被声明为 explicit，以防止将错误代码隐式转换为异常对象，并被标记为 noexcept（[SWS_DM_01808]）。

在健壮性和并发性方面，规范保证了构造过程完全异常安全（exception safe）且线程安全（[SWS_DM_01808]）。由此确保了即使在并发诊断场景中，错误生成本身也不会引发进一步的异常或不一致性。该异常的生命周期遵循 C++ 的标准栈展开机制：在发生错误时，该对象在诊断函数内部创建，经由调用层级向上透传，并在离开处理该异常的 catch 块时被确定性销毁。

使用路径

使用 ara::diag::DiagSovdException 时的典型流程分为以下步骤：

• 应用程序在模块 diag 的接口上发起与 SOVD 相关的诊断操作。
• 负责的诊断组件检测到错误条件，并从 SOVD 错误域生成匹配的 ara::core::ErrorCode（[SWS_DM_01808]）。
• 该组件通过 explicit DiagSovdException(err) 构造异常并将其抛出（[SWS_DM_01808]、[SWS_DM_01807]）。
• 应用程序通过 catch (const ara::diag::DiagSovdException& ex) 或多态地通过 const ara::core::Exception& 捕获异常，以对错误状态做出响应。

时序图：触发 DiagSovdException 时的调用与处理顺序。来源：[SWS_DM_01807]、[SWS_DM_01808]。

错误场景

作为错误传输载体，该类本身用于处理异常状态（[SWS_DM_01807]）。其创建的形式化前置条件是提供已初始化的 ara::core::ErrorCode（[SWS_DM_01808]）。由于构造函数被声明为 noexcept，因此在对象创建本身时不会发生异常（[SWS_DM_01808]）。

解释：推测该实例持久封装了所传递的错误代码，以便下游错误处理程序可以通过 ara::core::Exception 的继承函数对其进行检查。 问题 Q-332b95b96849e379 (未决)在禁用 C++ 异常的系统配置中，诊断组件推测可能会优先采用备选错误机制，而 DiagSovdException 则代表了专用的异常处理路径。