TsgcHTTPServer › Événements › OnSendBufferFull
Se déclenche lorsque la file d'attente sortante d'une connexion cliente a atteint sa limite configurée, avant que la politique de débordement ne soit appliquée. Hérité du moteur serveur partagé ; voir Remarques.
property OnSendBufferFull: TsgcWSSendBufferFullEvent;
// TsgcWSSendBufferFullEvent = procedure(Connection: TsgcWSConnection; const QueueSize: Integer; var DropMessage: Boolean) of object—
OnSendBufferFull appartient au même mécanisme de file d'attente sortante par connexion utilisé dans l'ensemble des composants serveur sgc : lorsque la mise en file d'attente est activée et que la file d'une connexion contient déjà le nombre maximum configuré de messages, cet événement se déclenche avec la Connection concernée et le QueueSize actuel, avant que la politique de débordement (suppression du plus ancien, suppression du plus récent, ou déconnexion) ne soit appliquée. TsgcHTTPServer ne publie pas la propriété qui active et configure cette file d'attente, et il n'envoie jamais de messages WebSocket au travers de celle-ci, donc en pratique cet événement ne se déclenche pas sur ce composant ; il reste publié pour la compatibilité d'interface avec les autres composants serveur construits sur le même moteur. DropMessage arrive à True, mais comme la condition qui déclenche cet événement ne se produit pas ici, le laisser inchangé n'a aucun effet observable.
procedure OnSendBufferFull(Connection: TsgcWSConnection; const QueueSize: Integer;
var DropMessage: Boolean);
begin
WriteLn('#slow consumer ' + Connection.Guid + ': ' + IntToStr(QueueSize) + ' messages queued');
end;