结构体 ara::diag::SovdBulkData::DeletionError

结构体 [SWS_DM_01844] 表示 SOVD 诊断模块（AUTOSAR_AP_SWS_Diagnostics §8.53.4 “Struct: DeletionError”）中单个大容量数据对象删除过程失败时的错误结果。它将未删除数据元素 item 的元数据与发生的错误码 error 关联起来 [SWS_DM_01845]、[SWS_DM_01846]。作为纯值对象，它供调用方用于针对性地识别和原因分析失败的清理操作。

更多 ›

上下文

数据结构 [SWS_DM_01844] 描述了在 AUTOSAR Adaptive 的 SOVD（Service-Oriented Vehicle Diagnostics）框架内删除大容量数据（Bulk Data）过程中发生的单个错误（AUTOSAR_AP_SWS_Diagnostics §8.53.4 “Struct: DeletionError”）。作为接口 ara::diag::SovdBulkData 的组成部分，该结构体用于在清理或删除操作失败时，在受影响的数据元素与错误原因之间建立精确的映射。它将不可删除文件的元数据描述符与标准化的 AUTOSAR 错误码结合在一起。

交互主要在执行删除的诊断服务器或组件 ara::diag::SovdBulkData 与发起调用的诊断或应用逻辑之间发生。后者请求清理 Bulk 数据，并在出错时接收反馈，以确定哪些具体的数据集未能移除以及原因。相关组件的相互作用以及在尝试删除时返回错误对象的过程如下面的时序图所示。

时序图：返回 DeletionError 的失败 Bulk Data 删除的典型流程。来源：[SWS_DM_01844]、[SWS_DM_01845]、[SWS_DM_01846]、AUTOSAR_AP_SWS_Diagnostics §8.53.4.1 “Public Member Variables”

生命周期

结构体 [SWS_DM_01844] 被设计为纯值对象（Plain Old Data / 值类型）。恰好在处理特定大容量数据元素的删除任务检测到错误时，在诊断基础设施端对其进行实例化。此时，字段 item 使用相应的 BulkDataMetaDataDescriptor [SWS_DM_01845] 进行初始化，字段 error 使用具体的错误码 ara::core::ErrorCode [SWS_DM_01846] 进行初始化。

关于所有权关系，该实例（或此类实例的集合）通常作为返回值或在错误容器内转移至调用方所有。解释：该结构体不拥有自己的长期资源或活动线程；其生命周期直接绑定到调用方错误处理块或结果容器的作用域（Scope）。 问题 Q-60f135b9e36d7083 (未决)在由应用程序评估后，该结构体与其成员变量一起按标准在栈上或堆中销毁。由于它是一个被动数据包，因此结构体内部不会出现内部状态转换或并发同步要求。

使用路径

在常规用例中，诊断组件或 SOVD 客户端通过接口 SovdBulkData 发起删除一个或多个大容量数据对象的操作。若至少有一个元素未能成功删除，平台将生成 DeletionError 的实例 [SWS_DM_01844]。

调用方接收错误对象并评估这两个公共变量（AUTOSAR_AP_SWS_Diagnostics §8.53.4.1 “Public Member Variables”）：

• item：应用程序通过 BulkDataMetaDataDescriptor 识别其删除失败的具体数据元素 [SWS_DM_01845]。
• error：应用程序借助 ara::core::ErrorCode 确定删除过程失败的准确原因 [SWS_DM_01846]。

基于这些信息，调用逻辑可以做出差异化响应，例如记录错误、选择备用清理策略或将详细错误原因上报给上级 SOVD 客户端。

错误场景

结构体 DeletionError 本身不抛出异常也不报告自身的错误码，而是专门用作信息载体以封装先前删除操作的失败。核心错误语义通过类型为 ara::core::ErrorCode 的变量 error 提供 [SWS_DM_01846]。该代码详细说明了由 item 引用的的大容量数据对象 [SWS_DM_01845] 无法删除的原因（例如拒绝访问、资源锁定或文件系统错误）。

进行有效评估的前提条件是，变量 item 和 error 已由生成它们的 SovdBulkData 运行时环境赋予了有效的上下文数据。检查完成后，该结构体不需要开发人员执行任何清理操作。