结构体 apext::tsync::FVContainer

结构体 apext::tsync::FVContainer 在模块 tsync 中用作数据容器，用于在应用程序与 Freshness Value Management 之间传递和返回新鲜度值。它在 value 中将实际的新鲜度值封装为字节向量（根据方向包含完整值或截断值 [SWS_TS_14196]），并在属性 length 中封装其精确的位长度 [SWS_TS_14195]。并发访问需要调用方进行外部协调。

更多 ›

上下文

结构体 apext::tsync::FVContainer 在 AUTOSAR Adaptive Platform 的功能集群 tsync 内充当新鲜度值（Freshness Values）的专用数据容器。通过头文件 apext/tsync/fvm.h 引入，它在与 Freshness Value Management（FVM）的交互中充当标准化接口。其主要职责是提供实际的加密新鲜度值及其精确长度。为此，容器在数据元素 length 中封装了位长度 [SWS_TS_14195]，并在字节向量 value 中封装了实际的有效数据 [SWS_TS_14196]。因此，该结构体在调用应用程序或协议层与 FVM 计算例程之间充当桥梁。

生命周期

作为轻量级数据结构（struct），apext::tsync::FVContainer 遵循 C++ 的常规值语义。其创建通常在调用方的栈上本地执行，或在更高级别的报文构建过程中动态执行。随着实例化，该结构体接管了所包含类型为 ara::core::Vector<std::uint8_t> 的向量 value 的生命周期责任 [SWS_TS_14196]。如果该结构体在传递给接口时按值或引用传递，则向量的 RAII 原则可确保在容器销毁时确定性地释放所分配的内存。 问题 Q-416ceca84f9cfdaf (未决)由于 apext::tsync::FVContainer 未提供内部同步机制，因此在并发读写访问时的线程安全协调完全由调用软件组件负责。

使用路径

在实际使用中，apext::tsync::FVContainer 在接口通信内经历两个核心方向：

• 输入参数：在验证或处理传入报文时，容器由应用程序填充并传递给 FVM 的方法。根据上下文，字段 value 可以接收完整的新鲜度值或截断值（Truncated Values）[SWS_TS_14196]。与此同时，字段 length 指定所包含值的精确位数 [SWS_TS_14195]。当新鲜度值的有效性不在整数字节边界处结束时，这一点尤为重要。
• 返回值：当 FVM 生成新鲜值时，相应的方法会返回 apext::tsync::FVContainer 的实例。调用上下文随后通过 length [SWS_TS_14195] 读取由 FVM 确定的以位为单位的有效长度，并从 value [SWS_TS_14196] 中提取相应的字节，以便将它们嵌入到后续的安全协议中。

Interpretation：存放在 length 中的位数大概率始终与向量 value 向上取整后的字节大小相对应，从而可以通过长度规范精确界定向量最后一个字节中未完全使用的剩余位。 问题 Q-e8feae8a93c14191 (未决)