结构体 ara::diag::DiagnosticSovdContentData

结构 ara::diag::DiagnosticSovdContentData 用作标准化数据容器，用于封装 AUTOSAR Adaptive（[SWS_DM_02385]）中 SOVD 服务的内容。它在内容元素的公共向量（[SWS_DM_02386]）中保存有效负载数据，Diagnostic Management 在操作和状态响应中根据这些内容元素生成 SOVD 属性 parameters。作为纯值传输对象，该结构不提供内部线程同步，因此并发修改必须在应用程序内部进行保障。

更多 ›

上下文

数据结构 ara::diag::DiagnosticSovdContentData 是 AUTOSAR Adaptive Platform 的诊断模块（diag）的一部分，并在头文件 ara/diag/diagnostic_sovd_content_data.h（AUTOSAR_AP_SWS_Diagnostics §8.59 “Header: ara/diag/diagnostic_sovd_content_data.h”、[SWS_DM_02385]）中声明。它充当标准化数据载体，用于在符合 ASAM SOVD 的面向服务的车辆诊断中封装诊断内容。

在平台内，该结构在诊断服务器（Diagnostic Management，DM）与 Adaptive Application 的服务提供者之间进行中介（[SWS_DM_01396]、[SWS_DM_02174]）。当外部 SOVD 客户端触发操作或状态查询时，DM 会将调用委托给实现它的软件组件。应用程序生成的输出数据存储在 DiagnosticSovdContentData 的实例中（[SWS_DM_02386]）。随后，DM 将这些内容传输到 SOVD 响应体中，具体而言传输到标准化属性 parameters（[SWS_DM_02176]、[SWS_DM_02181]）中。

上下文图：DiagnosticSovdContentData 嵌入在 SOVD 客户端、Diagnostic Management 和诊断服务提供者之间的数据交换中。来源：[SWS_DM_01396]、[SWS_DM_02174]、[SWS_DM_02176]、[SWS_DM_02385]、[SWS_DM_02386]。

生命周期

定义为 C++ struct（AUTOSAR_AP_SWS_Diagnostics §8.59.1.1 “Public Member Variables”、[SWS_DM_02385]）赋予了 DiagnosticSovdContentData 数据容器的角色。该结构具有类型为 ara::core::Vector<DiagnosticSovdContentElementData>（[SWS_DM_02386]）的公共成员变量 elements，其中动态管理各个内容元素。

一旦为响应组装诊断数据，通常会在服务提供者方法内本地创建实例。对于像 Read（AUTOSAR_AP_SWS_Diagnostics §8.x “Read”）这样的异步接口，该对象被封装在 ara::core::Future<DiagnosticSovdContentData> 中。解释：在此，该结构可能通过传值或移动语义转入调用者的所有权中，因此其生命周期绑定到处理它的 Future 对象。 问题 Q-564c59896de41f85 (未决)

在并发方面，该结构不包含内部同步原语。解释：由于它是一个纯值传输对象（Value Object），因此可能不存在内部线程保护；对同一实例的并发访问因此必须由调用方应用程序逻辑进行同步。 问题 (未决)实例的销毁在离开管理上下文的作用域时自动发生。

使用路径

DiagnosticSovdContentData 的主要使用路径在于 SOVD 框架中同步操作执行以及状态查询期间提供有效负载数据：

1. 外部 SOVD 客户端向车辆发送根据 ASAM SOVD 启动操作的请求（[SWS_DM_01396]）。
2. 在验证约束条件后，Diagnostic Management 通过 ara::diag::GenericDiagnosticSovdOperation::StartExecution 将执行委托给负责的操作（[SWS_DM_02174]）。
3. 服务应用程序执行诊断操作，实例化 DiagnosticSovdContentData 并使用生成的元素数据填充成员 elements（[SWS_DM_02386]）。
4. 该对象在同步执行的返回值上下文中传递给 Diagnostic Management（[SWS_DM_02176]）。
5. Diagnostic Management 从 DiagnosticSovdContentData 读取值，将其传输到 SOVD 响应体的属性 parameters 中，并将响应发送给客户端（[SWS_DM_02176]）。

类似的路径适用于通过 SovdOperationExecution::GetStatus（[SWS_DM_02180]）进行的状态查询，其中属性 parameters 同样派生自传递的 DiagnosticSovdContentData（[SWS_DM_02181]）。同样，内容提供者使用相同的结构作为通过 Read 的返回类型（AUTOSAR_AP_SWS_Diagnostics §8.x “Read”）。

序列图：在同步操作执行期间使用 DiagnosticSovdContentData 提供有效负载数据。来源：[SWS_DM_01396]、[SWS_DM_02174]、[SWS_DM_02176]、[SWS_DM_02386]。