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

속성으로 돌아가기