类 ara::tsync::TsyncException

异常类 ara::tsync::TsyncException 用于封装和传递在 Adaptive Platform 内的时间同步期间发生的错误。它派生自 ara::core::Exception，并在构造时强制接收一个描述错误原因的特定 ara::core::ErrorCode [SWS_TS_00903]。构造函数声明为 noexcept，从而保证异常的实例化以异常安全和线程安全的方式运行 [SWS_TS_00903]。应用程序可能会在其错误处理路径中捕获该异常，以便有针对性地评估所包含的错误码。 问题 (未决)

更多 ›

上下文

类 ara::tsync::TsyncException 代表 AUTOSAR Adaptive Platform 内针对 Time Synchronization（tsync）功能领域的专用异常类。根据规范，它在头文件 ara/tsync/tsync_error_domain.h 中声明，并用作表示由时间同步引发的异常的核心类型 [SWS_TS_00903]。通过从基类 ara::core::Exception 公有派生，它无缝融入平台级错误处理架构中。

在系统架构中，ara::tsync::TsyncException 承担时间同步服务的实现组件与应用模块之间信息载体的角色。如果在同步上下文中发生严重错误，该错误不会被孤立丢弃，而是以标准化异常的形式进行报告。该类在此过程中与 ara::core::ErrorCode 紧密协作，后者对错误的具体原因进行编码并封装 [SWS_TS_00903]。

上下文图：ara::tsync::TsyncException 在与 Time Synchronization、ara::core::ErrorCode 及 ara::core::Exception 协作中的定位。来源：[SWS_TS_00903]

生命周期

ara::tsync::TsyncException 实例的生命周期始于其显式实例化。规范为此提供了一个接收恰好一个 ara::core::ErrorCode 类型错误码的构造函数：explicit TsyncException(ara::core::ErrorCode errorCode) noexcept [SWS_TS_00903]。通过声明为 explicit，防止了错误码被隐式且非故意地转换为异常对象。

对于对象创建，AUTOSAR 制定了严格的保证：构造被明确指定为异常安全（exception safe）和线程安全（thread-safe）[SWS_TS_00903]。关键字 noexcept 保证构造函数本身在任何情况下都不会抛出进一步的异常 [SWS_TS_00903]。这是必不可少的，因为异常创建通常发生在错误处理路径中，此时发生故障将导致不受控制的系统状态。

创建之后，该对象遵循常规的 C++ 异常语义：它沿着调用栈传递，直到被相应的处理程序捕获。随着离开 catch 块，异常实例的生命周期结束，资源被确定性地释放。

使用路径

使用 ara::tsync::TsyncException 时的典型流程分为错误识别、对象创建和应用端捕获：

• 错误识别：Time Synchronization 在运行时检测到偏差或错误状态，并生成合适的 ara::core::ErrorCode [SWS_TS_00903]。
• 异常创建与抛出：使用构造函数实例化带有已确定错误码的 ara::tsync::TsyncException 对象并抛出 [SWS_TS_00903]。
• 错误捕获：调用组件在结构化异常处理块中捕获异常。

开发人员在其应用程序中既可以有针对性地将其作为 const ara::tsync::TsyncException& 进行处理，也可以通过基类 const ara::core::Exception& 多态捕获该异常 [SWS_TS_00903]。 问题 Q-0c8129359ef114e8 (未决)若要访问类型定义，需要包含头文件 ara/tsync/tsync_error_domain.h [SWS_TS_00903]。

错误场景

作为异常类，ara::tsync::TsyncException 用于显式表示错误场景。其核心组成部分是封装的 ara::core::ErrorCode，它提供了关于错误域内特定错误原因的详细信息 [SWS_TS_00903]。

一个重要特征是缺少无参默认构造函数。这确保了不存在没有关联错误码的异常实例 [SWS_TS_00903]。构造函数的 noexcept 保证进一步确保了错误的封装和指示不会被次级异常错误所叠加 [SWS_TS_00903]。