TsgcWSPServer_sgc › Properties › History

History Właściwość

Opcje historii wiadomości per kanał (Enabled, Size, TTLSeconds) używane do odzyskiwania po ponownym połączeniu.

Składnia

property History: TsgcWSHistoryOptions read FHistory write SetHistory;

Wartość domyślna

—

Uwagi

Gdy historia jest włączona, każdej wiadomości opublikowanej na kanale przypisywany jest monotoniczny offset, a wiadomość jest przechowywana w ograniczonym buforze per kanał. Klienci, którzy ponownie subskrybują po ponownym połączeniu, wysyłają swój ostatnio widziany offset, a serwer ponownie odtwarza wiadomości, które przegapili. Historia jest opcjonalna (opt-in) i domyślnie wyłączona, dzięki czemu dotychczasowe zachowanie pozostaje niezmienione, dopóki jej nie włączysz.

• Enabled — Boolean, domyślnie False. Włącza historię per kanał. Gdy False, serwer nie przechowuje historii i zachowuje się dokładnie jak wcześniej.
• Size — Integer, domyślnie 1000. Maksymalna liczba wiadomości przechowywanych na kanał. Ustaw 0, aby uzyskać brak limitu (ograniczone tylko dostępną pamięcią i TTLSeconds, jeśli ustawiono).
• TTLSeconds — Integer, domyślnie 0. Gdy większe od 0, wpisy starsze niż ta liczba sekund są usuwane. 0 oznacza brak wygasania opartego na czasie. W .NET ten składnik nosi nazwę TtlSeconds.

W wielowęzłowym Cluster historia jest w tej wersji lokalna dla węzła: odzyskiwanie po ponownym połączeniu działa, gdy klient ponownie łączy się z tym samym węzłem, który przechowuje historię kanału. Współdzielenie historii między węzłami Cluster jest planowane w przyszłej wersji.

Przykład

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

Wróć do Właściwości