TsgcWSPClient_sgcMéthodes › GetLastOffset

GetLastOffset Méthode

Renvoie le dernier offset de message que le client a vu sur un canal.

Syntaxe

function GetLastOffset(const aChannel: String): Int64;

Paramètres

NomTypeDescription
aChannelconst String Nom du canal dont l'offset suivi est renvoyé.

Valeur de retour

Le dernier offset reçu sur le canal. Renvoie 0 lorsque le client n'a encore reçu aucun message sur le canal (ou lorsque l'historique des messages n'est pas activé sur le serveur).

Remarques

Le client conserve un curseur par canal avec l'offset du dernier message qu'il a reçu pendant que l'historique des messages est activé sur le serveur. C'est ce curseur qu'un simple Subscribe envoie lors de la reconnexion afin que le serveur ne renvoie que les messages que le client a manqués. Utilisez GetLastOffset pour inspecter ce curseur, par exemple pour le persister entre les redémarrages de l'application ou pour déclencher une relecture explicite via Subscribe(aChannel, aSinceOffset).

En .NET, les méthodes correspondantes SetLastOffset et ClearOffsets vous permettent de restaurer ou de réinitialiser les curseurs suivis.

Exemple

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

Retour aux méthodes