结构体 ara::diag::DataIdentifierConcurrencyType

结构 ara::diag::DataIdentifierConcurrencyType 指定与数据标识符（Data Identifier）关联的诊断端口所允许的并发行为 [SWS_DM_00936]。应用程序通过成员变量 read、write 和 readWrite 定义 Diagnostic Management（DM）可以在何种程度上并行执行读取和写入调用。作为一项基本边界条件，所有字段默认以 ConcurrencyType::kNotConcurrent 进行防御性预初始化，从而只有在显式设置为 kConcurrent 时才会放行并发执行 [SWS_DM_00939]。

更多 ›

上下文

C++ 结构 ara::diag::DataIdentifierConcurrencyType 在 AUTOSAR Adaptive Platform 中用于指定与诊断数据标识符（Data Identifier，DID）关联的端口上的并发行为 [SWS_DM_00936]。它用作标准化的配置数据类型，应用软件通过该类型向诊断运行时系统声明其并行处理能力（AUTOSAR_AP_SWS_Diagnostics §8.8.2 “Struct: DataIdentifierConcurrencyType”）。该结构是模块 diag 接口定义的一部分（AUTOSAR_AP_SWS_Diagnostics 第79页）。

核心交互伙伴是 Diagnostic Management（DM）。传入的诊断请求由 DM 接收并转发给 DataIdentifier 端口的相应方法。根据 DataIdentifierConcurrencyType 中存放的值，DM 决定读取和写入操作是可以并发调用还是必须按顺序串行化 [SWS_DM_00939]。

生命周期

该结构通过头文件 ara/diag/concurrency.h 包含，并实例化为纯 C++ 数据对象（struct）[SWS_DM_00936]。在创建时，所有包含的成员变量均防御性地初始化为默认值 ConcurrencyType::kNotConcurrent [SWS_DM_00937]。这确保了在未经应用程序显式允许的情况下，DM 不会执行并行调用。

结构配置的生命周期通常绑定到关联 DataIdentifier 端口的初始化。应用程序创建对象，设置所需的并发度并将配置传递给端口。在随后的活动诊断运行期间，这些设置保持不变，以便 Diagnostic Management 可以确定性地调度方法调用（AUTOSAR_AP_SWS_Diagnostics §8.8.2.1 “Public Member Variables”）。

该结构将并发性划分为三个正交的配置字段：

• read：定义仅读取访问（Reads）的并发类型 [SWS_DM_00937]。
• write：定义写入访问（Writes）的并发类型 [SWS_DM_00938]。
• readWrite：定义共同、并行调用读取和写入方法时的行为 [SWS_DM_00939]。

使用路径

常规使用路径始于自适应应用程序提供诊断服务。如果端口的内部实现是线程安全的，则应用程序可以放行读取和写入访问的并行执行。为此，将创建 DataIdentifierConcurrencyType 的实例并将字段 readWrite 设置为 ConcurrencyType::kConcurrent [SWS_DM_00939]。同样，可以根据需要配置 read 和 write [SWS_DM_00937]、[SWS_DM_00938]。

一旦 DataIdentifier 端口在 DM 中注册，DM 就会接收外部诊断命令并对其进行转发（AUTOSAR_AP_SWS_Diagnostics 第1115页）。在设置了 kConcurrent 的情况下，DM 可以同时执行传入的读取和写入调用，从而优化吞吐量和延迟 [SWS_DM_00939]。如果配置保持默认值 kNotConcurrent，则 DM 将串行化调用。

时序图：Diagnostic Management（DM）进行配置和并发调用控制的典型流程。来源：[SWS_DM_00936]、[SWS_DM_00939]。