类 ara::diag::DataTransferReadSession

该类用于在符合 [SWS_DM_01548] 的 AUTOSAR 自适应诊断模块内部，对基于诊断的读取传输的所有变体进行封装和结构化管理。在成功启动读取过程后，诊断服务器实例将传入的用于顺序数据块传输以及用于会话终止的请求委托给读取处理程序 [SWS_DM_01317] 的已注册方法。通过专门停用复制操作并同时支持移动语义，该类确保了对底层传输会话的唯一样权归属。

更多 ›

上下文

类 ara::diag::DataTransferReadSession 代表自适应诊断模块 [SWS_DM_01548] 中基于诊断的数据块读取所有变体的封装。在 RequestFileTransfer (0x38)、TransferData (0x36) 和 RequestTransferExit (0x37) 等标准化 UDS 服务的上下文中，该会话类充当诊断服务器内部运行时环境与特定于应用程序的读取处理程序 SWS Diagnostics §7 “Realization of TransferData and RequestTransferExit” 之间的纽带。它确保正在运行的读取操作——例如通过 ReadFile [SWS_DM_01314] 读取文件或通过 ReadDir [SWS_DM_01315] 读取目录——得到隔离管理并转发给相关的处理程序。

上下文图：DataTransferReadSession 在诊断服务器与应用程序处理程序之间的嵌入关系。来源：[SWS_DM_01317]、[SWS_DM_01318]、SWS Diagnostics §7 “Realization of TransferData and RequestTransferExit”

生命周期

ara::diag::DataTransferReadSession 的实例具有严格耦合到传输会话的生命周期。显式禁止通过默认构造函数进行创建 [SWS_DM_01549]。相反，会话是通过专用的模板构造函数进行初始化的，这些构造函数会注册特定于应用程序的处理程序 SWS Diagnostics §7 “Realization of TransferData and RequestTransferExit”。在实践中，实例化通常由诊断服务器或服务处理程序在启动文件传输时完成。 问题 Q-b0706bcd28c702c6 (未决)

为杜绝多重占用或不一致的会话状态，ara::diag::DataTransferReadSession 被设计为不可复制的单实例：复制构造函数 [SWS_DM_01553] 与复制赋值运算符 [SWS_DM_01554] 均已被删除（=delete）。所有权的传递仅通过移动语义提供。移动构造函数 [SWS_DM_01551] 和移动赋值运算符 [SWS_DM_01552] 被定义为 noexcept=default。销毁通过析构函数 [SWS_DM_01550] 确定性地发生，该析构函数同样被声明为 noexcept=default。据推测，通过 RequestTransferExit 完成传输会导致对象的释放。 问题 Q-c1999fd1f283a007 (未决)

使用路径

读取传输会话的典型流程分为三个连续阶段：

• 初始化：外部诊断客户端发送带有读取模式（如 ReadFile (0x04) [SWS_DM_01314] 或 ReadDir (0x05) [SWS_DM_01315]）的 RequestFileTransfer。此时将创建会话实例并注册读取处理程序。
• 数据传输：诊断服务器通过调用经由模板构造函数注册的处理程序所对应的 Read 方法来处理传入的 TransferData (0x36) 类型诊断请求 [SWS_DM_01317]。这会针对每个请求的数据块迭代发生。
• 完成：一旦所有数据传输完毕，客户端就会发送 RequestTransferExit (0x37)。诊断服务器随后调用已注册处理程序的 Exit 方法，以规范终止读取过程 [SWS_DM_01318]。

时序图：带有移交给已注册会话的 UDS 读取传输调用序列。来源：[SWS_DM_01314]、[SWS_DM_01315]、[SWS_DM_01317]、[SWS_DM_01318]

错误场景

由于 ara::diag::DataTransferReadSession 被声明为 final 且默认构造函数 [SWS_DM_01549] 不存在，在编译期即可防止在没有已注册处理程序的情况下进行错误创建。同样，已删除的复制操作 [SWS_DM_01553] 阻止了意外复制会话状态的情况。移动构造、移动赋值以及销毁均通过其 noexcept 规范保证了绝对的异常安全性 [SWS_DM_01551] [SWS_DM_01550]。如果处理程序中的数据块提供失败，则会在 UDS 通信中于协议层级进行处理。