TsgcWSPClient_sgcMétodos › GetLastOffset

GetLastOffset Método

Retorna o último offset de mensagem que o cliente viu em um canal.

Sintaxe

function GetLastOffset(const aChannel: String): Int64;

Parâmetros

NameTypeDescrição
aChannelconst StringNome do canal cujo offset rastreado é retornado.

Valor de retorno

O último offset recebido no canal. Retorna 0 quando o cliente ainda não recebeu nenhuma mensagem no canal (ou quando o Histórico de Mensagens não está ativado no servidor).

Observações

O cliente mantém um cursor por canal com o offset da última mensagem que recebeu enquanto o Histórico de Mensagens está ativado no servidor. Esse cursor é o que um Subscribe simples envia na reconexão, para que o servidor reenvie apenas as mensagens que o cliente perdeu. Use GetLastOffset para inspecionar esse cursor, por exemplo para persisti-lo entre reinícios da aplicação ou para acionar um reenvio explícito via Subscribe(aChannel, aSinceOffset).

No .NET, os métodos correspondentes SetLastOffset e ClearOffsets permitem restaurar ou redefinir os cursores rastreados.

Exemplo

LastOffset := oProtocol.GetLastOffset('news');

Voltar para Métodos