结构体 ara::diag::GenericRoutine::OperationOutput

结构体 ara::diag::GenericRoutine::OperationOutput 在 AUTOSAR Adaptive [SWS_DM_00633] 中用作通用例程服务肯定响应消息的返回结构体。在成功执行例程后，应用程序实例化该结构体，并用结果的有效负载数据填充成员 responseData SWS Diagnostics 第80页。一个重要的约束条件是，向量 responseData 仅包含纯结果数据，且显式不得包含 RoutineIdentifier [SWS_DM_00633]。

更多 ›

上下文

结构体 ara::diag::GenericRoutine::OperationOutput 在 AUTOSAR Adaptive 的诊断模块中用作通用例程服务肯定响应消息的专用数据容器 [SWS_DM_00633]。它可通过头文件 ara/diag/generic_routine.h 获取 [SWS_DM_00633]，并封装了自适应诊断应用程序在成功处理例程后返回给诊断管理（ara::diag）的有效负载数据。主要有三个实体参与交互：作为例程请求发送方的外部诊断仪、用于协议处理的平台框架 ara::diag，以及执行业务逻辑并提供结果的 GenericRoutine 的应用专用实现 SWS Diagnostics 第80页。OperationOutput 的核心任务是以结构化方式提供例程的纯输出数据，其中 RoutineIdentifier 明确不是该数据结构的一部分 [SWS_DM_00633]。

生命周期

作为轻量级数据结构（struct），OperationOutput 具有简单的值生命周期。一旦针对例程的命令（例如启动、停止或结果查询）成功完成，自适应诊断应用程序就会按需进行实例化。唯一的数据成员是 ara::core::Vector<std::uint8_t> 类型的 responseData [SWS_DM_00633]。应用程序分配该向量，使用应用专用的返回数据对其进行填充，并将就绪的结构体传递给诊断子系统。返回给诊断框架通常应通过 ara::core 的 Result 或 Future 类型异步进行（解释：Adaptive Platform 的异步接口约定）。 问题 Q-e672dfb8b9ff416a (未决)在传递之后，序列化的职责转移给 ara::diag。一旦数据被传输或被接纳到内部缓冲区中，该结构体将在离开相应作用域时被再次销毁。在并发方面需要注意的是，OperationOutput 是针对单个操作执行的上下文创建的；常规情况下不会发生跨多个线程的共享、无保护访问。

使用路径

使用 OperationOutput 的常规流程包含多个连续阶段：

• 请求接收：诊断客户端发送 UDS RoutineControl 请求，该请求由诊断层转发给负责的 GenericRoutine 实例 SWS Diagnostics 第84页。
• 执行：自适应应用程序执行所请求的例程并处理输入参数。
• 结果生成：成功执行后，应用程序创建 OperationOutput 的实例，并使用生成的值字节填充 responseData [SWS_DM_00633]。
• 响应传递：该结构体作为肯定操作结果返回给 ara::diag。
• 响应传输：诊断管理推测在组装 UDS 响应时自动将 RoutineIdentifier 置于 responseData 字段之前（解释：守护进程对协议头的补充），并将整个数据包发送给客户端 [SWS_DM_00633]。 问题 Q-ccdd2867b87d00d1 (未决)

时序图：成功执行例程时通过 OperationOutput 提供数据的典型流程。来源：[SWS_DM_00633]、SWS Diagnostics 第80页。

错误场景

如果在执行例程期间发生错误或传入的输入数据无效，则 OperationOutput 的使用路径将被中止。在错误情况下，应用程序应向 Diagnostic Management 发送错误代码而非 OperationOutput，从而触发一条负面 UDS 响应（解读：通过 Result/Error-Domain 的错误路径）。 问题 (未决)因此，使用 OperationOutput 的基本先决条件是例程操作已完整且无误地完成。作为后置条件，应用程序保证 responseData 仅包含正面响应消息的纯有效载荷数据，并且不包含诸如 RoutineIdentifier 等协议前缀 [SWS_DM_00633]。如果例程成功结束但未生成任何附加返回数据，则向量 responseData 保持为空 SWS Diagnostics 第70页。