类 ara::per::PerException

类 ara::per::PerException 在 AUTOSAR Adaptive Platform 中用作特定的异常类型，用于指示来自持久化模块的错误。它通过头文件 ara/per/per_error_domain.h 提供，并继承自基类 ara::core::Exception [SWS_PER_00355]。实例化通过显式传递封装了具体错误原因的 ara::core::ErrorCode 进行。通过将构造函数声明为 noexcept，创建被指定为完全异常安全且线程安全的 [SWS_PER_00355]。

更多 ›

上下文

类 ara::per::PerException 在 Release R25-11 的 AUTOSAR Adaptive Platform 中充当持久化功能集群（模块 per）的核心专用异常类型。根据其形式语法，该类公有派生自常规基异常 ara::core::Exception。其主要职责是将来自持久化子系统的严重错误状态或无法通过常规返回值直接处理的错误状态指示给上层应用层。该类在头文件 ara/per/per_error_domain.h 中定义 [SWS_PER_00355]。在架构中，它与平台的错误处理基础设施紧密交互，每个实例携带一个 ara::core::ErrorCode 用于准确的错误诊断 [SWS_PER_00355]。

生命周期

ara::per::PerException 对象的生命周期与持久化操作中错误的识别和传递直接相关。实例化通过一个显式构造函数进行，该构造函数恰好接收一个类型为 ara::core::ErrorCode 的参数 [SWS_PER_00355]。该构造函数被声明为 explicit 以阻止从错误代码进行的隐式类型转换，并带有规范 noexcept [SWS_PER_00355]。这确保了在异常对象本身的构造期间不会出现其他异常；因此该创建是完全异常安全的（exception safe）[SWS_PER_00355]。

关于并发性，ara::per::PerException 的创建被指定为线程安全的（thread-safe）[SWS_PER_00355]。调用构造函数后，对象沿调用栈抛出。所有权关系和销毁遵循异常处理的标准 C++ 规则：对象保留在运行时系统的内存区域中，直到捕获的 catch 块结束，随后被确定性地销毁。

使用路径

使用 ara::per::PerException 的典型流程分为以下步骤：

• 错误识别与代码生成：持久化模块识别出无效状态或存储操作失败，并将其映射到相应的 ara::core::ErrorCode 中。
• 实例化：传入此错误代码，通过 PerException(errorCode) 显式创建异常对象 [SWS_PER_00355]。
• 触发异常：持久化子系统从受影响的函数接口抛出该异常实例。
• 捕获与评估：调用方应用程序将该对象特化地作为 ara::per::PerException 捕获，或多态地作为 ara::core::Exception 或 std::exception 捕获。解读：应用程序随后应通过从基类继承的访问方法读取封装的 ara::core::ErrorCode，以启动针对性的故障排除措施。 问题 Q-6e48fd125d9938d8 (未决)

错误场景

由于 ara::per::PerException 用于表示错误，因此在错误场景中，对象创建的健壮性和错误信息的完整性处于核心地位。作为基本先决条件，构造函数需要一个有效的 ara::core::ErrorCode 作为输入参数 [SWS_PER_00355]。由于构造函数被声明为 noexcept，因此排除了在错误报告期间发生次级异常的可能性 [SWS_PER_00355]。此外，规定的线程安全性保证了即使在多个执行线程中并发发生错误，也不会发生数据损坏或未协调的副作用 [SWS_PER_00355]。