DEENESPTFRRUARHIKOZHNL

类 apext::com::secoc::ComSecOcFvmErrorDomain

[SWS_CM_12514] Upstream: RS_AP_00122, RS_AP_00127, RS_AP_00130

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

Defines a class representing the SecOc Freshness Value Manager error domain

Header-Datei#include "apext/com/secoc/fvm_error_domain.h"
Forwarding-Header#include "apext/com/com_fwd.h"
Scopenamespace apext::com::secoc
Basisklasse(n)ara::core::ErrorDomain
Unique IDAs per apext::com::secoc::ComSecOcFvmErrorDomain in [SWS_CORE_90023]

用户指南人工智能生成

定义 SecOC FVM 错误域,并将特定错误代码映射到消息文本及异常。
AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: 815063923fbe 来源 未决问题(2)
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

定义 SecOC FVM 错误域,并将特定错误代码映射到消息文本及异常。

类 apext::com::secoc::ComSecOcFvmErrorDomain 封装了 AUTOSAR Adaptive [SWS_CM_12514] 的 SecOC 通信模块中 Freshness Value Manager 的错误域。它将来自 ComSecOcFvmErrc 的错误代码映射到描述性文本,并允许将其转换为 ComSecOcFvmException 异常。通常在进程范围内通过辅助函数 GetComSecOcFvmErrorDomain() [SWS_CM_12521] 进行访问。如果禁用了编译器异常,则用于生成异常的方法将自动从重载解析中移除。

上下文

类 apext::com::secoc::ComSecOcFvmErrorDomain 为 Adaptive AUTOSAR 通信管理 [SWS_CM_12514] 中安全车载通信(SecOC)框架下的 Freshness Value Manager(FVM)定义了错误域(AUTOSAR_AP_SWS_CommunicationManagement §C.2.3 “Class: ComSecOcFvmErrorDomain”)。作为 ara::core::ErrorDomain 的 final 子类,它将特定于域的 FVM 错误状态集成到 AUTOSAR Adaptive 的全平台错误处理模型中。

为了封装错误标识符和异常类型,该类提供了两个核心类型别名:通过 Errc 引用错误代码枚举 ComSecOcFvmErrc [SWS_CM_12515](AUTOSAR_AP_SWS_CommunicationManagement §C.2.3.1 “Public Member Types”),而类型别名 Exception 则指定了专用异常类 ComSecOcFvmException [SWS_CM_12516](AUTOSAR_AP_SWS_CommunicationManagement §C.2.3.1 “Public Member Types”)。在进程范围内对该错误域实例的标准化访问通过自由函数 apext::com::secoc::GetComSecOcFvmErrorDomain() [SWS_CM_12521](AUTOSAR_AP_SWS_CommunicationManagement §C.2.2.1.1 “GetComSecOcFvmErrorDomain”)进行。

生命周期

通过无参默认构造函数 [SWS_CM_12517] 创建 ComSecOcFvmErrorDomain 的实例。通过声明为 constexpr 和 noexcept,保证了在编译时即可完成实例化且无分配风险,并且是完全异常安全的。

在运行期间,错误域通常充当进程中长生命周期的不可变单例(解读)。 问题 Q-fc901552d01e33de (未决)应用程序和中间件组件通常不会在本地实例化该域,而是使用通过 GetComSecOcFvmErrorDomain() 提供的常量引用 [SWS_CM_12521]。由于成员函数 Name() [SWS_CM_12518] 和 Message() [SWS_CM_12519] 是无状态且定义为 const noexcept,因此来自多个线程的并发读取访问是安全的,无需额外的同步机制。

使用路径

当 Freshness Value Manager 中发生错误时,调用方将沿着固定时序与错误域进行交互:

  • 获取引用:组件使用 GetComSecOcFvmErrorDomain() [SWS_CM_12521] 获取全局域引用。
  • 域标识:为了日志记录或诊断目的,可以通过 Name() 查询错误域的固定分配标识符 [SWS_CM_12518]。
  • 解析错误消息:根据传递的错误代码(CodeType),Message() 返回指向该错误静态、人类可读描述的指针 [SWS_CM_12519]。
  • 抛出异常:如果要基于异常处理错误路径,ThrowAsException() 会将 ara::core::ErrorCode 对象转换为相应的异常 [SWS_CM_12520]。
ComSecOcFvmErrorDomain 的典型用法调用方GetComSecOcFvmErrorDomain()ComSecOcFvmErrorDomainComSecOcFvmExceptionGetComSecOcFvmErrorDomain()const ComSecOcFvmErrorDomain&altFehlermeldung abfragenMessage(errorCode)const char* (Meldungstext)抛出异常ThrowAsException(errorCode)生成并抛出throw ComSecOcFvmException

时序图:通过 ComSecOcFvmErrorDomain 查询错误文本或触发异常的典型流程。来源:[SWS_CM_12519]、[SWS_CM_12520]、[SWS_CM_12521]

错误场景

函数 Name() [SWS_CM_12518] 和 Message() [SWS_CM_12519] 具有 noexcept 异常安全性,在任何情况下都不会抛出异常。推测在遇到未知的数值错误代码时,Message() 会返回通用默认字符串(解读)。 问题 Q-4f9834f33957160b (未决)

与此相反,方法 ThrowAsException() 按定义不是异常安全的(not exception safe),因为其显式任务是基于传递的 ara::core::ErrorCode 构造并抛出 ComSecOcFvmException 对象 [SWS_CM_12520]。工具链配置是一项重要前置条件:如果在编译器中禁用了 C++ 异常,则 ThrowAsException() 不参与重载解析 [SWS_CM_12520]。因此,无异常运行时环境中的调用方必须通过 ara::core::Result 或直接对错误代码求值来实现错误处理。

本指南由 AI 系统基于 AUTOSAR Adaptive R25-11 规范生成。

成员图

构造函数和析构函数

1

类型别名

2

类图

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G napext__com__secoc__ComSecOcFvmErrorDomain756 ComSecOcFvmErrorDomain + ComSecOcFvmErrorDomain() + Message() + Name() + ThrowAsException() nara__core__ErrorDomain335 ErrorDomain napext__com__secoc__ComSecOcFvmErrorDomain756->nara__core__ErrorDomain335

详细视图

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

构造函数和析构函数

Constructs a new apext::com::secoc::ComSecOcFvmErrorDomain object

constexpr ComSecOcFvmErrorDomain () noexcept;

方法

Message 函数

Returns the message associated with errorCode

const char * Message (CodeType errorCode) const noexcept override;
Name 函数

Returns a string constant associated with the apext::com::secoc:: ComSecOcFvmErrorDomain

const char * Name () const noexcept override;

Creates a new instance of apext::com::secoc::ComSecOcFvmException from errorCode and throws it. As per [SWS_CORE_10304], this function does not participate in overload resolution when C++ exceptions are disabled in the compiler toolchain.

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

类型别名

Errc 类型别名

Alias for the error code value enumeration

using Errc = ComSecOcFvmErrc;
Exception 类型别名

Alias for the exception base class

方法文档

函数 ComSecOcFvmErrorDomain [SWS_CM_12517] Upstream: RS_AP_00120, RS_AP_00127, RS_AP_00130

constexpr ComSecOcFvmErrorDomain () noexcept;
Header-Datei#include "apext/com/secoc/fvm_error_domain.h"
Scopeclass apext::com::secoc::ComSecOcFvmErrorDomain
Exception-Sicherheitexception safe

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

Record
AUTOSAR/AP/record/SWS_CM_12517
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_12517@rel:R25-11#1a3caf0a
Content hash
1a3caf0a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_12517
Status: valid/unmigrated Version: rel:R25-11#7ddf8164 Versionshistorie & Revisions (1 transition, 5 revision)
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/SWS_CM_12517@rel:R25-11#7ddf8164
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#31f284932026-09-30
  • R22-11rel:R22-11#fe7147412026-10-14
  • R23-11rel:R23-11#ef5a3f0e2026-10-14
  • R24-11rel:R24-11#00eff3c62026-10-14
  • R25-11rel:R25-11#7ddf81642026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 Message [SWS_CM_12519] Upstream: RS_AP_00120, RS_AP_00121, RS_AP_00130

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

Returns the message associated with errorCode

Header-Datei#include "apext/com/secoc/fvm_error_domain.h"
Scopeclass apext::com::secoc::ComSecOcFvmErrorDomain
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
errorCodeThe error code number.

Rückgabewert

TypBeschreibung
const char *The message associated with the errorCode

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

Record
AUTOSAR/AP/record/SWS_CM_12519
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_12519@rel:R25-11#0f1314f4
Content hash
0f1314f4
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_12519
Status: valid/unmigrated Version: rel:R25-11#9147a34b Versionshistorie & Revisions (1 transition, 5 revision)
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/SWS_CM_12519@rel:R25-11#9147a34b
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#6d8f1f592026-09-30
  • R22-11rel:R22-11#633314ad2026-10-14
  • R23-11rel:R23-11#a966445d2026-10-14
  • R24-11rel:R24-11#0dd035792026-10-14
  • R25-11rel:R25-11#9147a34b2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 Name [SWS_CM_12518] Upstream: RS_AP_00120, RS_AP_00127, RS_AP_00130

const char * Name () const noexcept override;

Returns a string constant associated with the apext::com::secoc:: ComSecOcFvmErrorDomain

AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: c28253f0fde1 来源 未决问题(1)
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

错误域类 apext::com::secoc::ComSecOcFvmErrorDomain 的成员函数 Name() 返回一个代表该错误域标识符的字符串常量 [SWS_CM_12518]。声明通过头文件 #include "apext/com/secoc/fvm_error_domain.h" 提供 [SWS_CM_12518]。该函数纯同步工作,不接受任何参数,并返回一个指向类型为 const char * 的不可变字符串的指针 [SWS_CM_12518]。

在错误处理方面,该接口被指定为 exception safe,并带有 C++ 标识符 noexcept [SWS_CM_12518]。因此,调用不会失败,也不会触发任何 C++ 异常。该查询函数不存在特定的错误码、反馈说明或向 DET 或 DEM 发送的报告。

由于它是一个返回静态字符串常量指针的只读 const 方法,因此其执行很可能是可重入且线程安全的。 问题 Q-75fa65f59869d0ab (未决)对于调用上下文不存在任何限制性的顺序条件。

该方法契合 Communication Management 针对 SecOC 和 Freshness Value Management 的扩展 AUTOSAR_AP_SWS_CommunicationManagement §1 “Release Changes” 第3页。它遵循与该模块其他错误域中同名函数相同的架构模式,即 ara::com::ComErrorDomain [SWS_CM_11331] 和 ara::com::e2e::ComE2EErrorDomain [SWS_CM_12507] 中的模式。

本使用说明系基于 AUTOSAR R25-11 规范自动创建。

实现者指南即将推出(复杂度 I1)

Header-Datei#include "apext/com/secoc/fvm_error_domain.h"
Scopeclass apext::com::secoc::ComSecOcFvmErrorDomain
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
const char *As per apext::com::secoc::ComSecOcFvmErrorDomain in [SWS_CORE_90023]

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

Record
AUTOSAR/AP/record/SWS_CM_12518
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_12518@rel:R25-11#06914117
Content hash
06914117
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_12518
Status: valid/unmigrated Version: rel:R25-11#5ac902af Versionshistorie & Revisions (1 transition, 5 revision)
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/SWS_CM_12518@rel:R25-11#5ac902af
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#9760d3542026-09-30
  • R22-11rel:R22-11#a377b2122026-10-14
  • R23-11rel:R23-11#97ff04352026-10-14
  • R24-11rel:R24-11#5e9d07722026-10-14
  • R25-11rel:R25-11#5ac902af2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 ThrowAsException [SWS_CM_12520] Upstream: RS_AP_00120, RS_AP_00121, RS_AP_00130

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

Creates a new instance of apext::com::secoc::ComSecOcFvmException from errorCode and throws it. As per [SWS_CORE_10304], this function does not participate in overload resolution when C++ exceptions are disabled in the compiler toolchain.

AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: ce36f40333e6 来源
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

使用

错误域 apext::com::secoc::ComSecOcFvmErrorDomain(SWS Communication Management §C.2.3.2.2.3 “ThrowAsException”,[SWS_CM_12520])的成员函数 ThrowAsException 用于将错误码转换为 C++ 异常。它接受类型为 const ara::core::ErrorCode& 的错误码 errorCode 的引用作为输入参数,并且没有返回值。该函数根据传入的错误码创建 apext::com::secoc::ComSecOcFvmException 的新实例并同步将其抛出([SWS_CM_12520])。

错误处理与异常安全性

该方法声明为 noexcept(false),且根据规范被归类为非异常安全(not exception safe)([SWS_CM_12520])。常规执行模式规定,该函数不会正常返回,而是在发生错误时将生成的异常 apext::com::secoc::ComSecOcFvmException 直接报告给调用方。

限制

对于该函数,存在关于编译器配置的重要限制:若在编译器工具链中禁用了 C++ 异常,则根据 [SWS_CORE_10304],ThrowAsException 不参与重载解析([SWS_CM_12520])。

相互作用

该行为符合 Communication Management 的统一部署错误模型。类似的函数也存在于通用通信域 ara::com::ComErrorDomain::ThrowAsException(SWS Communication Management §8.12.4.2.2.3 “ThrowAsException”,[SWS_CM_11333],其抛出 ara::com::ComException)以及端到端错误域 ara::com::e2e::ComE2EErrorDomain::ThrowAsException(SWS Communication Management §8.15.3.2.2.3 “ThrowAsException”,[SWS_CM_12509],其实例化 ara::com::e2e::ComE2EException)中。

本文由 AI 基于 AUTOSAR Adaptive R25-11 规范生成。

实现者指南即将推出(复杂度 I2)

Header-Datei#include "apext/com/secoc/fvm_error_domain.h"
Scopeclass apext::com::secoc::ComSecOcFvmErrorDomain
Exception-Sicherheitnot exception safe

Parameter (in)

ParameterBeschreibung
errorCodeThe error to throw.

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_12520
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_12520@rel:R25-11#cedd87ac
Content hash
cedd87ac
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_12520
Status: valid/unmigrated Version: rel:R25-11#437e51da Versionshistorie & Revisions (1 transition, 5 revision)
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/SWS_CM_12520@rel:R25-11#437e51da
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#0f6c419d2026-09-30
  • R22-11rel:R22-11#4114c69d2026-10-14
  • R23-11rel:R23-11#5a85b1842026-10-14
  • R24-11rel:R24-11#5616eddf2026-10-14
  • R25-11rel:R25-11#437e51da2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

类型别名文档

类型别名 Errc [SWS_CM_12515] Upstream: RS_AP_00120, RS_AP_00127, RS_AP_00130

using Errc = ComSecOcFvmErrc;

Alias for the error code value enumeration

Header-Datei#include "apext/com/secoc/fvm_error_domain.h"
Scopeclass apext::com::secoc::ComSecOcFvmErrorDomain
SymbolErrc

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

Record
AUTOSAR/AP/record/SWS_CM_12515
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_12515@rel:R25-11#02007a9a
Content hash
02007a9a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_12515
Status: valid/unmigrated Version: rel:R25-11#9e1c96ab Versionshistorie & Revisions (1 transition, 5 revision)
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/SWS_CM_12515@rel:R25-11#9e1c96ab
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#5e50cf262026-09-30
  • R22-11rel:R22-11#51831d2d2026-10-14
  • R23-11rel:R23-11#e6ef23242026-10-14
  • R24-11rel:R24-11#9e1c96ab2026-10-14
  • R25-11rel:R25-11#9e1c96ab2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

类型别名 Exception [SWS_CM_12516] Upstream: RS_AP_00120, RS_AP_00127, RS_AP_00130

using Exception = ComSecOcFvmException;

Alias for the exception base class

Header-Datei#include "apext/com/secoc/fvm_error_domain.h"
Scopeclass apext::com::secoc::ComSecOcFvmErrorDomain
SymbolException

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

Record
AUTOSAR/AP/record/SWS_CM_12516
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_12516@rel:R25-11#8553d8ec
Content hash
8553d8ec
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_12516
Status: valid/unmigrated Version: rel:R25-11#801578c5 Versionshistorie & Revisions (1 transition, 5 revision)
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/SWS_CM_12516@rel:R25-11#801578c5
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#81fce66a2026-09-30
  • R22-11rel:R22-11#3c90a4eb2026-10-14
  • R23-11rel:R23-11#3d2e52462026-10-14
  • R24-11rel:R24-11#fda471ba2026-10-14
  • R25-11rel:R25-11#801578c52026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill