3.1.2.1.9. LifespanQosPolicy Each data sample written by a DataWriter has an associated expiration time beyond which the data is removed from the DataWriter and DataReader history as well as from the transient and persistent information caches (s...-DPDK中文网

3.1.2.1.9 LifespanQosPolicy

描述

每个由 DataWriter 写入的数据样本都有一个相关的过期时间，超过该时间后，该数据将从 DataWriter 和 DataReader 的历史记录中删除，并且也会从临时和持久性信息缓存中移除（参见 LifespanQosPolicy）。

默认情况下，持续时间是无限的，这意味着没有最大有效期限限制写入 DataWriter 的样本。

过期时间是通过将持续时间添加到源时间戳来计算的，如果调用了 write() 成员函数，则可以自动计算该时间戳，也可以通过应用程序使用 write_w_timestamp() 成员函数提供。DataReader 可以使用接收时间戳而不是源时间戳。

QoS 策略数据成员列表：

数据成员名称	类型	默认值
duration	Duration_t	c_TimeInfinite

注意事项

此 QoS 策略适用于 Topic、DataReader 和 DataWriter 实体，并且可以在启用的实体上进行更改。

示例

// 此示例使用 DataWriter，但它也可以应用于 DataReader 和 Topic 实体
DataWriterQos writer_qos;
// LifespanQosPolicy 默认构造时持续时间设置为无限
// 将持续时间更改为 5 秒
writer_qos.lifespan().duration = {5, 0};
// 在创建相应实体时使用修改后的 QoS 设置
writer_ = publisher_->create_datawriter(topic_, writer_qos);

解释

LifespanQosPolicy：此策略定义了数据样本的有效期，允许开发者控制何时应该删除不再需要的数据。这对于内存管理和确保系统处理的新鲜数据尤为重要。
默认值为 c_TimeInfinite：这表示在没有明确指定有效期限的情况下，数据样本将永久保留，直到显式删除或超出其他QoS策略限制（例如流量控制等）。
过期时间计算：通过将指定的持续时间加到源时间戳，可以确定每个数据样本的生存期。源时间戳可由系统自动生成，也可以由应用程序手动设置，而接收方则可选择使用收到消息时的接收时间戳。
适用范围：此策略同样适用于不同的数据实体，使得开发人员能够针对特定场景灵活调整数据生命周期管理。
示例代码说明：示例展示了如何在 C++ 中创建一个包含 LifespanQosPolicy 的 DataWriter。首先初始化 DataWriterQos 对象，然后修改其生存期，将其设置为5秒，以便之后创建 DataWriter 时应用新的 QoS 设置。