TsgcWSPServer_sgc › 属性 › History

History 属性

用于重连恢复的按频道消息历史选项（Enabled、Size、TTLSeconds）。

语法

property History: TsgcWSHistoryOptions read FHistory write SetHistory;

默认值

—

备注

当启用历史时，发布到某个频道的每条消息都会被分配一个单调递增的偏移量，并保存在一个有界的按频道缓冲区中。在重新连接后重新订阅的客户端会发送它们最后看到的偏移量，服务器会重放它们错过的消息。历史需手动启用，默认处于禁用状态，因此在您启用它之前，现有行为保持不变。

• Enabled — Boolean，默认 False。开启按频道历史。当为 False 时，服务器不保留任何历史，行为与以前完全相同。
• Size — Integer，默认 1000。每个频道保留的最大消息数。设置为 0 表示无限制（仅受可用内存以及 TTLSeconds（若已设置）的限制）。
• TTLSeconds — Integer，默认 0。当大于 0 时，存留时间超过此秒数的条目会被逐出。0 表示没有基于时间的过期。在 .NET 中，此成员名为 TtlSeconds。

在多节点集群中，本版本的历史是节点本地的：当客户端重新连接到持有该频道历史的同一节点时，重连恢复才会生效。跨集群节点共享历史计划在未来版本中实现。

示例

oProtocol.History.Enabled := True;
oProtocol.History.Size := 1000;        // keep last 1000 messages per channel
oProtocol.History.TTLSeconds := 3600;  // optional: also expire after 1 hour

返回属性