类 ara::rds::RdsException

类 ara::rds::RdsException 表示 Raw Data Stream 模块的专用异常类型，用于基于 ara::core::ErrorCode 传递错误 [SWS_RDS_11292]。其实例化通常在通过 ThrowAsException 进行错误处理的上下文中发生，从而触发故障流程的结构化中止 [SWS_RDS_11297]。由于构造函数被声明为 noexcept，因此可确保在创建异常时运行时系统中不会发生后续错误。调用方应用程序代码必须捕获该异常，以防止程序中止。

更多 ›

上下文

在 AUTOSAR Adaptive 环境中，类 ara::rds::RdsException 用作 Raw Data Stream（rds）的专用异常类型，如 SWS RawDataStream §1 “Raw Data Stream” 中所规定。它直接派生自通用基类 ara::core::Exception，并将模块的错误模型无缝集成到平台的异常处理中。在 RDS 命名空间内，该类型通过类型别名 Exception 提供 [SWS_RDS_11327]，这为用户和模块组件提供了统一且简化的命名规范。主要交互对象包括错误域（例如 ara/rds/rds_error_domain.h 中声明的域）以及通过异常处理错误的应用程序代码 [SWS_RDS_11292]。

生命周期

一旦发生的错误事件强制中止常规控制流，就会按需创建 ara::rds::RdsException 的实例。实例化通过接受 ara::core::ErrorCode 对象的显式构造函数进行 [SWS_RDS_11292]。该构造函数声明为 noexcept，从而确保对象创建本身在任何情况下都不会失败或触发其他异常。该异常对象遵循常规 C++ 值语义：它在抛出时传递到运行时环境的异常存储区中。正如 ara::core 中异常类型的通常情况一样，一旦对异常对象的引用失效，销毁时间点应该与离开负责的 catch 块绑定。 问题 Q-5673ede6a9688b85 (未决)在并发执行环境中，该类表现出线程安全性，因为每个异常情况都在线程局部级别进行隔离实例化和传播。

使用路径

典型使用路径包括检测流操作中的错误状态、将错误代码转换为异常以及在应用程序代码中进行下游捕获。如果在操作期间发生错误，该错误主要表示为 ara::core::ErrorCode。可以通过封装了转换和触发过程的方法 ThrowAsException 来启动异常触发，而不是进行手动查询 [SWS_RDS_11297]。解释：对 ThrowAsException 的调用推测在内部直接委托给 RdsException 的构造函数，并通过 throw 抛出新创建的实例 [SWS_RDS_11292]。 问题 Q-d8734426a5c71e07 (未决)调用代码通过具体类型 ara::rds::RdsException、别名 ara::rds::Exception [SWS_RDS_11327] 或多态地通过 ara::core::Exception 捕获异常。

时序图：通过 ErrorCode 触发和捕获 RDS 异常时的相互作用。来源：[SWS_RDS_11292]、[SWS_RDS_11297]。

错误场景

围绕 ara::rds::RdsException 的错误场景主要涉及错误传播的一致性以及避免未处理的程序中止。触发操作 ThrowAsException 显式定义为 noexcept(false) [SWS_RDS_11297]，因为抛出异常代表发生错误时的预期行为。当调用代码忽略潜在的控制流中止且未提供匹配的异常处理程序时，就会出现严重的错误场景；不完整的处理会导致进程通过 std::terminate 立即中止。然而，通过构造函数 [SWS_RDS_11292] 的 noexcept 保证，确保了在提供异常本身时不会发生嵌套初始化错误。