类 ara::fw::FwErrorDomain

Diese Seite wurde vollständig KI-generiert auf Basis von SWS Firewall (R25-11) — kein offizieller AUTOSAR-Text und keine automatisch extrahierte API-Seite wie die übrigen Module. Als Interpretation gekennzeichnete Aussagen sind Schlussfolgerungen aus den Quellen.

[AP_SWS_Fw_83006] 原文尚未导入 · Header ara/fw/fw_error_domain.h

class FwErrorDomain final : public ara::core::ErrorDomain {...};

Class representing the firewall error domain.

Header-Datei	#include "ara/fw/fw_error_domain.h"
Scope	namespace ara::fw

用户指南人工智能生成

定义 Firewall 的错误域，用于将错误码转换为描述文本和模块特定异常。

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： d6dd4b1d5dfd 来源未决问题（2）

译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

定义 Firewall 的错误域，用于将错误码转换为描述文本和模块特定异常。

该类表示 Firewall 模块的错误域，并将模块特定的错误码与错误文本和异常 [AP_SWS_Fw_83007] 相关联。它提供错误码的描述，并支持针对性地引发模块特定异常 [AP_SWS_Fw_83011]、[AP_SWS_Fw_83012]。由于默认构造函数已删除，因此使用通过预先实例化的域进行，其接口按线程安全方式实现 [AP_SWS_Fw_83009]。

上下文

类 ara::fw::FwErrorDomain 表示 AUTOSAR Adaptive Platform 内 Firewall 模块（fw）的专用错误域。作为 ara::core::ErrorDomain 的特化，它为 Firewall 操作期间可能出现的所有错误状态定义语义上下文。通过封装在独立域中，确保 Firewall 模块的错误码可以在整个平台范围内被唯一定位，并与其它子系统的错误区分开来。

该接口的核心组成部分包括标准化的类型别名：通过 Errc 引用底层枚举 FwErrc [AP_SWS_Fw_83007]，而 Exception 则用作模块专用异常基类 FwException 的别名 [AP_SWS_Fw_83008]。该类通过方法 Name() 提供错误域的标识符 [AP_SWS_Fw_83010]。主要交互对象包括功能性 Firewall 实现、应用软件以及 ara::core 的上层错误处理基础设施。

生命周期

ara::fw::FwErrorDomain 的实例化受到严格规定的约束：无参默认构造函数被显式声明为已删除（FwErrorDomain() = delete）[AP_SWS_Fw_83009]。因此，用户无法在栈或堆上直接创建实例。根据错误域的平台标准，该域的实例通常作为全局单例存在，应用程序推测可以通过平台范围的访问函数对其进行访问。问题 Q-47a5220d4797865a (未决)

在所有权方面，错误域保留在运行时环境的控制之下，并在整个进程运行期具有静态生命周期。由于多个执行路径可以并行访问错误描述，因此核心检查方法 Name() 和 Message() 被指定为线程安全的（thread-safe）[AP_SWS_Fw_83010]，[AP_SWS_Fw_83011]。方法 ThrowAsException() 同样保证并发访问时的线程安全性 [AP_SWS_Fw_83012]。

使用路径

典型的使用路径分为模块端的错误生成、调用方的评估以及必要时转换为 C++ 异常。如果 Firewall 的操作失败，则会向调用方传递一个基于枚举 Errc [AP_SWS_Fw_83007] 并封装为 ara::core::ErrorCode 的错误。随后，用户可以通过该域查询详细的错误文本，或以确定性方式控制错误处理。

为了进行诊断或记录，应用程序将错误代码传递给方法 Message()，该方法将关联的文本描述作为常量字符指针返回 [AP_SWS_Fw_83011]。如果改为通过 C++ 异常继续执行，则使用相应的错误对象调用 ThrowAsException()，随后该方法实例化并抛出 Exception（FwException）的实例 [AP_SWS_Fw_83008]，[AP_SWS_Fw_83012]。

时序图：通过 FwErrorDomain 进行错误处理和异常抛出的典型流程。来源：[AP_SWS_Fw_83007]、[AP_SWS_Fw_83011]、[AP_SWS_Fw_83012]。

错误场景

用于信息查询的方法提供了针对运行时错误的严格保证。Name() 和 Message() 均声明为 noexcept，从而保证在查询标识符和错误文本期间不会抛出任何异常 [AP_SWS_Fw_83010]，[AP_SWS_Fw_83011]。Message() 的前置条件是传入 CodeType 类型的有效错误值 [AP_SWS_Fw_83011]。

相比之下，ThrowAsException() 显式带有 noexcept(false) 注解，因为其主要任务在于通过抛出 FwException 有针对性地中断常规控制流 [AP_SWS_Fw_83012]。根据规范，该函数被归类为非异常安全（not exception safe），因为它会生成并发出异常。因此，如果要避免程序提前终止，调用方必须确保对 ThrowAsException() 的调用嵌入在相应的 try-catch 块中。

本指南完全基于 Release R25-11 中 ara::fw::FwErrorDomain 的接口定义。

成员图

详细视图

请在大纲中选择一个条目。

此版本没有元素数据

构造函数和析构函数

FwErrorDomain 函数

Constructs a new FwErrorDomain object.

FwErrorDomain()=delete;

方法

Message 函数

Returns the message associated with errorCode.

const char *Message(CodeType errorCode) const noexcept override;

Name 函数

Retrieve the name of the error domain.

const char *Name() const noexcept override;

ThrowAsException 函数

Creates and throws FwException from an ErrorCode.

void ThrowAsException(const ara::core::ErrorCode &errorCode) const noexcept(false) override;

类型别名

Errc 类型别名

Alias for the error code enumeration.

using Errc = FwErrc;

Exception 类型别名

Alias for the exception base class.

using Exception = FwException;

点击条目以查看其关系。

方法与类型文档

类型别名 Errc [AP_SWS_Fw_83007]

using Errc = FwErrc;

Alias for the error code enumeration.

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： 2d5371474311 来源未决问题（1）

译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

根据 [AP_SWS_Fw_83007]，类型别名 Errc 被定义为错误代码枚举 FwErrc 的别名（using Errc = FwErrc;）。该元素在类 ara::fw::FwErrorDomain 的作用域内声明，并通过头文件 ara/fw/fw_error_domain.h 包含 [AP_SWS_Fw_83007]。

在用法方面，Errc 不代表可执行的函数调用，因此既没有参数、返回值，也不具备同步或异步语义 [AP_SWS_Fw_83007]。相反，它为域特定错误原因的枚举提供了统一的标识符。解释：该别名可能为开发人员提供对 ara::fw::FwErrorDomain 内部 FwErrc 枚举值的简化且一致的访问，以便对错误状态进行类型化和查询 [AP_SWS_Fw_83007]。问题 Q-bd8949830961e459 (未决)

由于它纯粹是编译时构造，因此不存在关于可重入性、线程安全或调用顺序的运行时限制 [AP_SWS_Fw_83007]。规范元素中未预设特定的错误值或与 DET 或 DEM 消息的关联，而是取决于底层枚举的值 [AP_SWS_Fw_83007]。

本使用说明由 AI 自动生成，基于 AUTOSAR 规范版本 R25-11。

Header-Datei	#include "ara/fw/fw_error_domain.h"
Scope	class ara::fw::FwErrorDomain

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/AP_SWS_Fw_83007
Status: valid/unmigrated
Version: AUTOSAR/AP/record/AP_SWS_Fw_83007@rel:R25-11#49b3a8bf
Content hash: 49b3a8bf
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Firewall.pdf#nameddest=AP_SWS_Fw_83007

Status: valid/unmigrated Version: rel:R25-11#fe5a5208 Versionshistorie & Revisions (1 transition)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/AP_SWS_Fw_83007@rel:R25-11#fe5a5208

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

类型别名 Exception [AP_SWS_Fw_83008]

using Exception = FwException;

Alias for the exception base class.

Header-Datei	#include "ara/fw/fw_error_domain.h"
Scope	class ara::fw::FwErrorDomain

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/AP_SWS_Fw_83008
Status: valid/unmigrated
Version: AUTOSAR/AP/record/AP_SWS_Fw_83008@rel:R25-11#2f53006d
Content hash: 2f53006d
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Firewall.pdf#nameddest=AP_SWS_Fw_83008

Status: valid/unmigrated Version: rel:R25-11#58425750 Versionshistorie & Revisions (1 transition)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/AP_SWS_Fw_83008@rel:R25-11#58425750

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 FwErrorDomain [AP_SWS_Fw_83009]

FwErrorDomain()=delete;

Constructs a new FwErrorDomain object.

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： b2e3248af0ca 来源未决问题（1）

译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

默认构造函数 FwErrorDomain() 被声明为已删除（[AP_SWS_Fw_83009]）。因此，在应用程序代码中排除了通过此构造函数直接实例化类 ara::fw::FwErrorDomain 的对象。Interpretation：删除该构造函数推测是为了确保该错误域仅作为单例进行管理。问题 Q-54f7bc341f074e2c (未决)

要使用该错误域，可使用自由函数 GetFwErrorDomain()（[AP_SWS_Fw_83002]）。该函数以线程安全的方式返回对类型为 ara::core::ErrorDomain 的现有域对象的引用。通过此引用可以使用该域的接口：

通过 Name() 查询错误域的名称（[AP_SWS_Fw_83010]）。
通过 Message() 获取错误代码的描述性文本（[AP_SWS_Fw_83011]）。
通过 ThrowAsException() 抛出异常（[AP_SWS_Fw_83012]），其中别名 Exception 指向 FwException（[AP_SWS_Fw_83008]）。

关联的错误代码由枚举 FwErrc 定义（[AP_SWS_Fw_83001]），该枚举在类内部也可通过别名 Errc 使用（[AP_SWS_Fw_83007]）。有效值为 kServiceNotAvailable 以及 kInvalidStateDependentFirewall。因此，开发人员不应创建自己的实例，而应始终使用全局引用。

本文本由 AI 系统基于规范生成。

实现者指南即将推出（复杂度 I1）

Header-Datei	#include "ara/fw/fw_error_domain.h"
Scope	class ara::fw::FwErrorDomain

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/AP_SWS_Fw_83009
Status: valid/unmigrated
Version: AUTOSAR/AP/record/AP_SWS_Fw_83009@rel:R25-11#bbca44e8
Content hash: bbca44e8
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Firewall.pdf#nameddest=AP_SWS_Fw_83009

Status: valid/unmigrated Version: rel:R25-11#5ebf65c6 Versionshistorie & Revisions (1 transition)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/AP_SWS_Fw_83009@rel:R25-11#5ebf65c6

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 Name [AP_SWS_Fw_83010]

const char *Name() const noexcept override;

Retrieve the name of the error domain.

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： 6d5ba8b80ab1 来源未决问题（1）

译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

用法与语义

类 ara::fw::FwErrorDomain 的成员函数 Name 用于检索错误域的标识符 [AP_SWS_Fw_83010]。调用同步进行，并且需要包含头文件 ara/fw/fw_error_domain.h [AP_SWS_Fw_83010]。该函数不接受任何传递参数，并返回表示域名称的类型为 const char * 的指针 [AP_SWS_Fw_83010]。返回值可能是一个以空字符结尾的字符串，其有效期受限于错误域的生命周期。问题 Q-6bd465d82e79a682 (未决)

错误处理

该方法使用标识符 noexcept 进行声明 [AP_SWS_Fw_83010]。因此它不抛出异常，也不提供特定的错误代码或错误返回值 [AP_SWS_Fw_83010]。

并发性与限制

根据规范，该函数被归类为线程安全（thread-safe）[AP_SWS_Fw_83010]。由于它是常量成员函数（const），访问不会改变实例的状态，可以安全地从不同执行上下文中并发调用 [AP_SWS_Fw_83010]。根据规范，不存在特殊的前置条件或顺序要求 [AP_SWS_Fw_83010]。

本使用说明基于 AUTOSAR Adaptive R25-11 规范状态自动生成。

Header-Datei	#include "ara/fw/fw_error_domain.h"
Scope	class ara::fw::FwErrorDomain
Thread-Sicherheit	thread-safe

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/AP_SWS_Fw_83010
Status: valid/unmigrated
Version: AUTOSAR/AP/record/AP_SWS_Fw_83010@rel:R25-11#2da0543e
Content hash: 2da0543e
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Firewall.pdf#nameddest=AP_SWS_Fw_83010

Status: valid/unmigrated Version: rel:R25-11#57023588 Versionshistorie & Revisions (1 transition)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/AP_SWS_Fw_83010@rel:R25-11#57023588

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 Message [AP_SWS_Fw_83011]

const char *Message(CodeType errorCode) const noexcept override;

Returns the message associated with errorCode.

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： 476d9af969d8 来源未决问题（1）

译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

使用

类 ara::fw::FwErrorDomain 的成员函数 Message 通过头文件 ara/fw/fw_error_domain.h 声明，用于同步检索错误消息 [AP_SWS_Fw_83011]。调用时，调用方传递类型为 CodeType 的错误代码 errorCode。作为返回值，该函数返回指向分配给该错误代码的字符串的类型为 const char * 的指针 [AP_SWS_Fw_83011]。该函数作为 override 重写基类 [AP_SWS_Fw_83011] 的相应接口。

并发与线程安全

规范明确将 Message 定义为 thread-safe [AP_SWS_Fw_83011]。因此，调用方无需额外的同步措施即可从不同线程针对同一实例并行调用该方法。通过限定为 const 方法，调用时错误域的状态不会被改变 [AP_SWS_Fw_83011]。

错误处理与边界条件

由于声明为 noexcept，该方法保证不抛出 C++ 异常 [AP_SWS_Fw_83011]。元素中未针对无法解析的代码定义特定的错误代码或错误值 [AP_SWS_Fw_83011]。返回的指针可能指向不可变的、静态分配的字符串，因此调用方没有内存管理义务。问题 Q-2e98884ffd517367 (未决)

本文由基于 AUTOSAR 规范的 AI 支持的文档系统生成。

Header-Datei	#include "ara/fw/fw_error_domain.h"
Scope	class ara::fw::FwErrorDomain
Thread-Sicherheit	thread-safe

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/AP_SWS_Fw_83011
Status: valid/unmigrated
Version: AUTOSAR/AP/record/AP_SWS_Fw_83011@rel:R25-11#07990e73
Content hash: 07990e73
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Firewall.pdf#nameddest=AP_SWS_Fw_83011

Status: valid/unmigrated Version: rel:R25-11#c4d84a2a Versionshistorie & Revisions (1 transition)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/AP_SWS_Fw_83011@rel:R25-11#c4d84a2a

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 ThrowAsException [AP_SWS_Fw_83012]

void ThrowAsException(const ara::core::ErrorCode &errorCode) const noexcept(false) override;

Creates and throws FwException from an ErrorCode.

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： a4633c240f7f 来源未决问题（1）

译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

类 ara::fw::FwErrorDomain 的成员函数 ThrowAsException 用于从传递的错误代码 errorCode 实例化并触发 FwException [AP_SWS_Fw_83012]。该函数通过头文件 ara/fw/fw_error_domain.h 包含，并接受对 ara::core::ErrorCode 的常量引用作为唯一参数 [AP_SWS_Fw_83012]。它没有返回值（void），并声明为 const 以及 override [AP_SWS_Fw_83012]。

通过规范条款 noexcept(false) 明确定义了方法调用时允许抛出异常；该函数确定性地为相应错误情况创建并抛出 FwException [AP_SWS_Fw_83012]。关于异常安全性，该方法被归类为 not exception safe [AP_SWS_Fw_83012]。因此，调用代码必须做好准备，以应对生成的异常中断常规控制流，并需要采取相应的异常处理措施。

在并发方面，该方法被规范为 thread-safe，从而允许多个线程同时调用 [AP_SWS_Fw_83012]。通过关键字 override，该方法可能重写了上级错误域的同名接口函数 [AP_SWS_Fw_83012]。问题 Q-aae02c046243335c (未决)

本使用说明由 AI 生成，基于 R25-11 版本的 AUTOSAR 规范。

Header-Datei	#include "ara/fw/fw_error_domain.h"
Scope	class ara::fw::FwErrorDomain
Thread-Sicherheit	thread-safe
Exception-Sicherheit	not exception safe

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/AP_SWS_Fw_83012
Status: valid/unmigrated
Version: AUTOSAR/AP/record/AP_SWS_Fw_83012@rel:R25-11#5468af1c
Content hash: 5468af1c
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Firewall.pdf#nameddest=AP_SWS_Fw_83012

Status: valid/unmigrated Version: rel:R25-11#ce2cde5d Versionshistorie & Revisions (1 transition)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/AP_SWS_Fw_83012@rel:R25-11#ce2cde5d

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

类 ara::fw::FwErrorDomain

用户指南人工智能生成

上下文

生命周期

使用路径

错误场景

成员图

构造函数和析构函数

方法

类型别名

详细视图

构造函数和析构函数

方法

类型别名

方法与类型文档

类型别名 Errc [AP_SWS_Fw_83007]

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

类型别名 Exception [AP_SWS_Fw_83008]

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 FwErrorDomain [AP_SWS_Fw_83009]

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 Name [AP_SWS_Fw_83010]

用法与语义

错误处理

并发性与限制

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 Message [AP_SWS_Fw_83011]

使用

并发与线程安全

错误处理与边界条件

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 ThrowAsException [AP_SWS_Fw_83012]

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents: