结构体 ara::diag::SovdBulkData::DeleteByCategoryResult

结构体 ara::diag::SovdBulkData::DeleteByCategoryResult 在 SOVD 诊断模块（[SWS_DM_01926]）中删除某个类别的所有大容量数据时提供聚合结果。它将结果分为成功删除的条目（deleted_items）以及包含错误原因的故障实例（failed_items）（[SWS_DM_01842]、[SWS_DM_01843]）。调用方必须评估这两个列表，以便确定性地处理部分成功的情况。

更多 ›

上下文

结构 ara::diag::SovdBulkData::DeleteByCategoryResult 作为面向服务的车辆诊断（SOVD）海量数据管理领域中“Delete All Bulk Data Defined by Category”方法的标准化结果类型（[SWS_DM_01926]、AUTOSAR_AP_SWS_Diagnostics §8.53.3 “Struct: DeleteByCategoryResult”）。在 AUTOSAR Adaptive Diagnostics 模块（diag）中，诸如日志文件、跟踪记录或测量序列等海量数据可被归配至语义类别。当诊断客户端通过接口 ara::diag::SovdBulkData 请求删除某类别下的所有实例时，该数据结构会汇总该操作的总体状态（AUTOSAR_AP_SWS_Diagnostics §8.53.3 “Definition of API class ara::diag::SovdBulkData::DeleteByCategoryResult”）。

交互伙伴通常包括外部 SOVD 客户端或诊断应用程序、功能性诊断接口 ara::diag::SovdBulkData 以及用于大容量数据的内部持久化子系统。结果对象通过聚合所有受影响数据对象的状态，跨越了同步或异步执行单元与评估客户端之间的边界。

生命周期

根据头文件 #include "ara/diag/sovd_bulk_data.h" 中的类定义，它是一个不带自身复杂状态逻辑（[SWS_DM_01842]、[SWS_DM_01843]）的被动数据结构（struct）。它在按类别删除大容量数据完成之后，由诊断运行时环境在服务器端立即创建。在此过程中，成员变量 deleted_items 和 failed_items 会被填充相应的描述符和错误对象。

由于它是一个纯数据传输结构，在 Adaptive 平台上下文中向调用方的传递大概通过按值（Value）或移动（Move）语义进行——例如打包在异步结果容器中。 问题 Q-bafa9fbd3ae683c1 (未决)此时所有权完全转移给调用方。对象的销毁以及所包含 ara::core::Vector 实例内存的释放，在离开调用方作用域（Scope）时确定性地发生。在实例级别不存在共享并发；针对不同类别的并行删除请求会生成相互独立的实例。

使用路径

典型的使用流程包括启动删除、由诊断服务执行以及调用方对结果对象进行分别评估：

1. 诊断客户端通过按类别删除的方法请求移除所有相关的大容量数据。
2. 服务器迭代指定类别的实例并执行删除过程。
3. 成功移除的条目被记录在列表 deleted_items 中（[SWS_DM_01842]）。
4. 失败的实例及其各自的错误原因被收集在 failed_items 中（[SWS_DM_01843]）。
5. 聚合的 DeleteByCategoryResult 被返回给调用方（[SWS_DM_01926]），由调用方确认成功的删除并评估可能出现的错误。

时序图：按类别删除大容量数据从请求、聚合到评估的流程。来源：[SWS_DM_01926]、[SWS_DM_01842]、[SWS_DM_01843]、AUTOSAR_AP_SWS_Diagnostics §8.53.3 “Struct: DeleteByCategoryResult”。

错误场景

大容量数据删除的一个核心特征是存在部分成功的可能性。由于一个类别可以汇聚大量独立的数据集，因此总体操作在出现个别错误时并不必然失败。对调用方而言，拆分为两个独立的向量推测意味着正在发生不带原子回滚的部分处理。 问题 Q-35307a7eccf0afa9 (未决)

个别数据集的错误删除通过元素 failed_items 传递，该元素被类型化为 ara::core::Vector<DeletionError>（[SWS_DM_01843]、AUTOSAR_AP_SWS_Diagnostics §8.53.3.1.2 “failed_items”）。作为完全成功报告的前提条件，调用方必须检查 failed_items.empty() 是否成立。若列表包含元素，则可以针对每个受影响的大容量数据实例分析具体的删除错误（例如因活动读取访问导致的锁定或权限不足）。同时，deleted_items 可靠地记录了尽管存在个别错误但仍能成功删除的所有数据集（[SWS_DM_01842]）。