TsgcWebSocketLoadBalancerServerEreignisse › OnClientFragmented

OnClientFragmented Ereignis

Wird ausgelöst, wenn ein fragmentierter binärer Frame von einem Downstream-Client empfangen wird, bevor er an den Backend-Server weitergeleitet wird.

Syntax

property OnClientFragmented: TsgcWSLBServerBinaryEvent;
// TsgcWSLBServerBinaryEvent = procedure(Connection: TsgcWSConnection; Data: TMemoryStream; var Handled: Boolean) of object

Standardwert

Hinweise

OnClientFragmented wird ausgelöst, wann immer der Load Balancer eine fragmentierte WebSocket-Nachricht von einem Client empfängt (aktiviert über Options.FragmentedMessages auf dem zugrunde liegenden Server). Connection ist die Downstream-Session und Data enthält die Nutzlast für das aktuelle Fragment. Setzen Sie Handled auf True, um das Fragment im Load Balancer zu konsumieren und seine Weiterleitung an das Backend zu verhindern; belassen Sie es auf False, damit der Load Balancer das Fragment unverändert weiterleitet. Typische Verwendung ist die leichtgewichtige Inspektion oder Filterung sehr großer Uploads, ohne die gesamte Nachricht wieder zusammenzusetzen.

Beispiel


procedure OnClientFragmented(Connection: TsgcWSConnection; Data: TMemoryStream;
  var Handled: Boolean);
begin
  Log(Format('Fragment %d bytes from %s', [Data.Size, Connection.Guid]));
  Handled := False;
end;

Zurück zu Ereignissen