类 ara::diag::DataTransferReadByPullHandler

类 ara::diag::DataTransferReadByPullHandler 用于提供文件或目录数据，这些数据由诊断层 AraDiag 在 UDS 读取操作过程中从应用程序中主动检索（[SWS_DM_01506]）。该流程包括通过 Read() 进行逐步数据检索，直至通过 ExitRead() 最终完成会话。作为严格的生命周期前置条件，与恰好单个传输会话关联的处理程序实例绝不能在调用 ExitRead() 之前被销毁（[SWS_DM_01510]）。

更多 ›

上下文

类 ara::diag::DataTransferReadByPullHandler（[SWS_DM_01506]、AUTOSAR_AP_SWS_Diagnostics §8.10.2 “Class: DataTransferReadByPullHandler”）处理由用于读取文件或目录的诊断请求（例如 RequestReadFile 或 RequestReadDirectory）所启动的数据传输。该架构基于拉取（Pull）机制，其中诊断层 AraDiag 主动从实现中查询（“pulled”）待传输的数据。

交互涉及三个组件：外部 UDS 客户端（诊断测试仪）、诊断子系统 AraDiag 以及应用程序特定的处理程序实现。外部客户端发送读取请求，随后 AraDiag 调用处理程序的方法以逐步提供数据块并将其传输至 UDS 客户端（[SWS_DM_01513]）。

生命周期

处理程序实例的生命周期专门绑定至单个文件传输会话。默认构造函数声明为 protected（[SWS_DM_01507]）。Interpretation：因此具体应用程序应实现并实例化一个派生子类。 问题 Q-cb78bc4a1d40968b (未决)

复制操作被完全禁用：复制构造函数（[SWS_DM_01509]）和复制赋值运算符（[SWS_DM_01512]）被指定为已删除（=delete），因为处理程序专用于会话内的单向使用（“only one way usage i.e. per single file transfer session”）。相比之下，移动操作（移动构造函数和移动赋值）被定义为默认实现并声明为 noexcept（[SWS_DM_01508]、[SWS_DM_01511]、AUTOSAR_AP_SWS_Diagnostics §8.10.2.1.1.1 “Move Constructor”）。

对于释放存在严格的前置条件：在调用方法 ExitRead() 之前，绝不能销毁该类的实例（[SWS_DM_01510]、AUTOSAR_AP_SWS_Diagnostics §8.10.2.1.1.2 “Destructor”）。关于并发性，接口方法 Read() 和 ExitRead() 被定义为非线程安全（“not thread-safe”），但具备异常安全性（noexcept）（[SWS_DM_01513]、[SWS_DM_01514]）。

使用路径

数据检索的常规流程分为以下步骤：

1. 初始化：应用程序为即将进行的传输会话实例化派生的处理程序类。
2. 数据检索：为了提供数据块，AraDiag 调用方法 Read()（[SWS_DM_01513]、AUTOSAR_AP_SWS_Diagnostics §8.10.2.1.3.2 “Read”）。应用程序接收到指向由 AraDiag 预分配缓冲区的内存视图 response_data（类型为 ara::core::Span<const ara::core::Byte>），用接下来的文件内容填充该缓冲区，并以写入的字节数完成 ara::core::Future<std::uint32_t>。AraDiag 将这些数据作为 transferResponseParameterRecord 插入到块序号（blockSequenceCounter）之后的 UDS 肯定响应中（[SWS_DM_01513]）。此步骤针对后续数据块重复执行。
3. 会话结束：为了正常终止传输，AraDiag 调用 ExitRead()（[SWS_DM_01514]、AUTOSAR_AP_SWS_Diagnostics §8.10.2.1.3.1 “ExitRead”）。传入的参数包括终止原因 exit_type、制造商特定参数（transfer_request_parameter_record）、meta_info 以及一个 cancellation_handler。实现通过 ara::core::Future<ara::core::Vector<ara::core::Byte>> 对此进行确认，其返回值在肯定响应中于 SID 之后传输（[SWS_DM_01514]）。
4. 释放：仅在成功调用 ExitRead() 之后，才允许销毁处理程序对象（[SWS_DM_01510]）。

时序图：通过 AraDiag 采用拉取机制进行数据检索的典型流程。来源：[SWS_DM_01513]、[SWS_DM_01514]

错误场景

如果在数据准备或结束过程中发生错误，应用程序会通过返回的 Future 进行报告，具体方式是为其提供 UDS 错误代码（符合 ISO 14229-1 的 DiagUdsNrcErrc）（[SWS_DM_01513]、[SWS_DM_01514]）。随后 AraDiag 向测试仪生成相应的 UDS 否定响应（NRC）。

针对提前取消，向两个方法均传递一个 CancellationHandler（[SWS_DM_01513]、[SWS_DM_01514]）。应用程序可以通过 cancellation_handler.IsCanceled() 检查对话是否已取消，或者通过 cancellation_handler.SetNotifier() 注册回调函数。所提供的缓冲区（response_data 和 transfer_request_parameter_record）在 Promise 完成或通过处理程序取消之前保持有效。

如果在调用 ExitRead() 之前销毁实例，则违反了规范要求（[SWS_DM_01510]），这可能导致不完整的传输会话和未定义系统状态。