TsgcWebSocketHTTPServerEvents › OnHandshake

OnHandshake Ereignis

Wird ausgelöst, nachdem der Handshake auf der Serverseite ausgewertet wurde und bevor die Antwort gesendet wird.

Syntax

property OnHandshake: TsgcWSHandshakeEvent;
// TsgcWSHandshakeEvent = procedure(Connection: TsgcWSConnection; var Headers: TStringList) of object

Standardwert

Hinweise

OnHandshake wird auf dem Server unmittelbar nach dem Parsen und Validieren der HTTP-Upgrade-Anfrage eines Clients ausgelöst, und bevor die Handshake-Antwort zurückgeschrieben wird. Die vom Client gesendeten eingehenden Header sind über die Eigenschaft HeadersRequest der Verbindung verfügbar (gecastet auf TsgcWSConnectionServer). Der Parameter Headers ist eine TStringList, die die zurückzugebenden Antwortzeilen enthält; fügen Sie benutzerdefinierte Zeilen hinzu (zum Beispiel einen herstellerspezifischen Header), um sie in die HTTP-Antwort aufzunehmen. Standard-WebSocket-Header (Upgrade, Connection, Sec-WebSocket-Accept...) sind bereits befüllt und sollten nicht dupliziert werden. Dieses Ereignis wird nicht für einfache HTTP-Anfragen ausgelöst, die von OnCommandGet bedient werden.

Beispiel


procedure OnServerHandshake(Connection: TsgcWSConnection; var Headers: TStringList);
begin
  ShowMessage(TsgcWSConnectionServer(Connection).HeadersRequest.Text);
end;

Zurück zu Ereignissen