类 ara::nm::NmErrorDomain

错误域 ara::nm::NmErrorDomain 封装了 AUTOSAR Adaptive Platform 中 Network Management 的错误处理，并集成了错误码 NmErrc 以及异常类 NmException [SWS_ANM_01101]。其主要任务包括通过 Message() 提供易读的错误消息，以及通过 ThrowAsException() 受控地抛出关联的异常 [SWS_ANM_01108]。作为关键约束条件，其实例化和所有成员函数均实现为线程安全（thread-safe），从而确保了整个系统中并发错误查询的安全。

更多 ›

上下文

在 AUTOSAR Adaptive Platform 中，类 ara::nm::NmErrorDomain 充当 Network Management 子系统的领域特定错误域 [SWS_ANM_01101]。作为基类 ara::core::ErrorDomain 的 final 特化，它提供了标准化框架，用于标识、文本描述和转发在 Network Management 功能运行期间可能出现的错误 [SWS_ANM_01101]。

在 NM 错误处理概念中，该类将具体的错误原因与运行时环境的常规错误处理机制关联起来。在此过程中，该类通过类型别名定义了与相关类型的直接映射：通过别名 Errc 引入底层枚举 NmErrc，该枚举声明了 Network Management 的特定错误码 [SWS_ANM_01103]。同时，它通过别名 Exception 引用特化异常类 NmException，从而在需要时可以将错误转换为 C++ 异常机制 [SWS_ANM_01104]。通过这种整合，NmErrorDomain 充当模块错误状态与 ara::core 的特定错误基础系统之间的核心纽带。

生命周期

ara::nm::NmErrorDomain 实例的创建通过无参默认构造函数 [SWS_ANM_01105] 进行。由于该类被指定为 final，派生错误域的进一步细分或特化被明确禁止 [SWS_ANM_01101]。构造函数声明为 noexcept，从而保证错误域的实例化绝不会抛出异常 [SWS_ANM_01105]。

关于所有权关系，该错误域的实例通常作为长生命周期的全局对象存在于内存中，以便通过错误码对象中的引用实现持久可用。 问题 Q-27fedf008cefcdc7 (未决)生命周期中的一个重要特征是并发行为：无论是实例的构造 [SWS_ANM_01105]，还是所有接口函数（如名称查询 [SWS_ANM_01106]、消息生成 [SWS_ANM_01107] 以及抛出异常 [SWS_ANM_01108]），均设计为完全线程安全（thread-safe）。由于 NmErrorDomain 的实例不包含可变状态，因此可以无需额外同步措施在多个线程中并发使用。

使用路径

一旦需要在 Network Management 中分析、记录错误状态或将其转换为异常，常规使用路径便会启动。错误域为此提供了基本的标识和求值功能。

对于域的常规标识，可以调用方法 Name()，该方法将域名作为常量字符串指针返回 [SWS_ANM_01106]。当应用程序或基础系统希望确定所发生错误码的文本含义时，会在传递该错误码的情况下调用方法 Message() [SWS_ANM_01107]。该方法将关联的错误消息作为 const char* 返回，并通过其 noexcept 声明保证诊断过程本身保持异常安全 [SWS_ANM_01107]。

若控制流需要抛出系统特定异常，则使用方法 ThrowAsException() [SWS_ANM_01108]。该函数接收类型为 ara::core::ErrorCode 的错误对象，并抛出与之匹配的类型为 NmException 的异常 [SWS_ANM_01104]、[SWS_ANM_01108]。在实践中，该调用推测主要通过错误对象的相应辅助方法间接进行。 问题 Q-70e50ac95d89f400 (未决)

时序图：通过错误域将 Network Management 错误码转换为特定类型的 NmException。来源：[SWS_ANM_01104]，[SWS_ANM_01108]。

错误场景

在错误处理框架内，该域覆盖了由枚举类型 NmErrc 通过别名 Errc 定义的所有模块错误情况 [SWS_ANM_01103]。该域本身旨在确定性地确保错误求值的安全性。

通过 Message() 获取文本消息时，其声明为 noexcept 确保了即使对于无效错误码也不会抛出非预期异常 [SWS_ANM_01107]。该类主动触发异常的唯一预见场景是显式调用 ThrowAsException() [SWS_ANM_01108]。通过声明 noexcept(false)，该方法表明其通过抛出 NmException 的实例强制将程序转入异常处理路径 [SWS_ANM_01104]、[SWS_ANM_01108]。因此，调用组件必须确保此类调用在需要时被相应的异常块捕获。