TsgcWebSocketHTTPServer Ereignisse

Ereignisse, die Sie behandeln können, nach Zweck gruppiert, gefolgt von der vollständigen alphabetischen Liste.

Lebenszyklus

Name	Beschreibung
OnStartup	Wird ausgelöst, nachdem der Server gestartet wurde und bereit ist, Verbindungen anzunehmen.
OnShutdown	Wird ausgelöst, nachdem der Server gestoppt wurde und keine Verbindungen mehr akzeptiert werden.
OnTCPConnect	Wird ausgelöst, nachdem sich ein Client auf TCP-Ebene verbunden hat und vor dem WebSocket-Handshake, sodass die Verbindung akzeptiert oder abgelehnt werden kann.
OnConnect	Wird jedes Mal ausgelöst, wenn eine WebSocket-Verbindung mit einem Client hergestellt wird.
OnDisconnect	Wird jedes Mal ausgelöst, wenn eine WebSocket-Verbindung mit einem Client getrennt wird.
OnHandshake	Wird ausgelöst, nachdem der Handshake auf der Serverseite ausgewertet wurde und bevor die Antwort gesendet wird.
OnError	Wird immer dann ausgelöst, wenn ein WebSocket-Protokollfehler auftritt, etwa ein fehlerhafter Handshake.
OnException	Wird ausgelöst, wenn beim Verarbeiten einer Client-Verbindung eine nicht behandelte Ausnahme auftritt.
OnUnknownProtocol	Wird ausgelöst, wenn die erste Nachricht keinem bekannten Protokoll entspricht, sodass die Verbindung akzeptiert oder abgelehnt werden kann.
OnUnknownAuthentication	Wird ausgelöst, wenn die Authentifizierung aktiviert ist und die Authentifizierungsmethode vom Server nicht erkannt wird.

Data

Name	Beschreibung
OnMessage	Wird jedes Mal ausgelöst, wenn ein Client eine Textnachricht sendet und sie vom Server empfangen wird.
OnBinary	Wird jedes Mal ausgelöst, wenn ein Client eine Binärnachricht sendet und sie vom Server empfangen wird.
OnFragmented	Wird ausgelöst, wenn ein Fragment einer Nachricht empfangen wird (nur wenn Options.FragmentedMessages frgAll oder frgOnlyFragmented ist).

HTTP

Name	Beschreibung
OnBeforeCommand	Wird vor OnCommandGet oder OnCommandOther ausgelöst, sodass die Anfrage geprüft, autorisiert oder kurzschlüssig mit einer 401-Antwort beantwortet werden kann.
OnCommandGet	Wird ausgelöst, wenn der HTTP-Server eine GET-, POST- oder HEAD-Anfrage empfängt, sodass die Anwendung die Antwort erstellen kann.
OnCommandOther	Wird ausgelöst, wenn der HTTP-Server eine andere Methode als GET, POST oder HEAD empfängt (PUT, DELETE, OPTIONS, PATCH...).
OnBeforeForwardHTTP	Wird ausgelöst, bevor eine HTTP-Anfrage versendet wird, damit sie an einen anderen HTTP-Server weitergeleitet (reverse-proxied) werden kann.
OnAfterForwardHTTP	Wird ausgelöst, nachdem eine HTTP-Anfrage weitergeleitet wurde, sodass die Anwendung das Ergebnis oder einen vom Upstream-Server zurückgegebenen Fehler prüfen kann.
OnHTTP2BeforeAsyncRequest	Wird ausgelöst, bevor eine HTTP/2-Anforderung eingereiht wird, sodass die Anwendung wählen kann, ob sie im Thread-Pool oder im Verbindungsthread ausgeführt wird.

Sitzungen

Name	Beschreibung
OnCreateSession	Wird ausgelöst, wenn der HTTP-Server eine neue Sitzung erstellen muss, sodass die Anwendung eine benutzerdefinierte TIdHTTPSession-Instanz bereitstellen kann.
OnSessionStart	Wird ausgelöst, wenn eine HTTP-Sitzung gestartet und zur SessionList hinzugefügt wird.
OnSessionEnd	Wird ausgelöst, wenn eine HTTP-Sitzung geschlossen wird, entweder explizit oder nach Ablauf von SessionTimeout.
OnInvalidSession	Wird ausgelöst, wenn eine HTTP-Anfrage eine unbekannte oder abgelaufene Sitzungs-ID präsentiert, sodass die Anwendung entscheiden kann, wie sie reagiert.

HTTP Upload

Name	Beschreibung
OnHTTPUploadBeforeSaveFile	Wird ausgelöst, bevor eine aus einem multipart/form-data-Upload extrahierte Datei auf die Festplatte gespeichert wird, sodass Name und Pfad angepasst werden können.
OnHTTPUploadAfterSaveFile	Wird ausgelöst, nachdem eine aus einem multipart/form-data-Upload extrahierte Datei auf der Festplatte gespeichert wurde.
OnHTTPUploadReadInput	Wird ausgelöst, wenn der multipart/form-data-Decoder ein Nicht-Datei-Eingabefeld liest, sodass dessen Wert erfasst werden kann.
OnHTTPUploadBeforeCreatePostStream	Wird ausgelöst, nachdem die Anfrage-Header gelesen wurden und bevor der POST-Stream erstellt wird, sodass der Upload angenommen oder abgelehnt werden kann.

Zuverlässigkeit

Name	Beschreibung
OnBeforeHeartBeat	Wird vor jedem HeartBeat-Ping ausgelöst, sodass die Anwendung ein benutzerdefiniertes Keep-Alive implementieren kann.
OnLoadBalancerConnect	Wird ausgelöst, wenn der Server sich mit dem Load Balancer Server verbindet.
OnLoadBalancerDisconnect	Wird ausgelöst, wenn sich der Server vom Load Balancer Server trennt.
OnLoadBalancerError	Wird ausgelöst, wenn bei der Kommunikation mit dem Load-Balancer-Server ein Fehler auftritt.

Sicherheit

Name	Beschreibung
OnAuthentication	Wird ausgelöst, wenn die Authentifizierung aktiviert ist, sodass die Anwendung Benutzer und Passwort prüfen und die Verbindung annehmen oder ablehnen kann.
OnSSLGetHandler	Wird ausgelöst, bevor der SSL-Handler erstellt wird, sodass eine benutzerdefinierte serverseitige Handler-Instanz bereitgestellt werden kann.
OnSSLAfterCreateHandler	Wird ausgelöst, nachdem der SSL-Handler erstellt wurde, sodass seine Eigenschaften angepasst werden können.
OnSSLALPNSelect	Wird während eines ALPN-fähigen Handshakes ausgelöst, sodass die Anwendung auswählen kann, welches Protokoll ausgehandelt werden soll.
OnSSLVerifyPeer	Wird ausgelöst, wenn VerifyCertificate aktiviert ist und der Client ein Zertifikat zur Annahme oder Ablehnung vorlegt.

Alle Ereignisse (alphabetisch)

Name	Beschreibung
OnAfterForwardHTTP	Wird ausgelöst, nachdem eine HTTP-Anfrage weitergeleitet wurde, sodass die Anwendung das Ergebnis oder einen vom Upstream-Server zurückgegebenen Fehler prüfen kann.
OnAuthentication	Wird ausgelöst, wenn die Authentifizierung aktiviert ist, sodass die Anwendung Benutzer und Passwort prüfen und die Verbindung annehmen oder ablehnen kann.
OnBeforeCommand	Wird vor OnCommandGet oder OnCommandOther ausgelöst, sodass die Anfrage geprüft, autorisiert oder kurzschlüssig mit einer 401-Antwort beantwortet werden kann.
OnBeforeForwardHTTP	Wird ausgelöst, bevor eine HTTP-Anfrage versendet wird, damit sie an einen anderen HTTP-Server weitergeleitet (reverse-proxied) werden kann.
OnBeforeHeartBeat	Wird vor jedem HeartBeat-Ping ausgelöst, sodass die Anwendung ein benutzerdefiniertes Keep-Alive implementieren kann.
OnBinary	Wird jedes Mal ausgelöst, wenn ein Client eine Binärnachricht sendet und sie vom Server empfangen wird.
OnCommandGet	Wird ausgelöst, wenn der HTTP-Server eine GET-, POST- oder HEAD-Anfrage empfängt, sodass die Anwendung die Antwort erstellen kann.
OnCommandOther	Wird ausgelöst, wenn der HTTP-Server eine andere Methode als GET, POST oder HEAD empfängt (PUT, DELETE, OPTIONS, PATCH...).
OnConnect	Wird jedes Mal ausgelöst, wenn eine WebSocket-Verbindung mit einem Client hergestellt wird.
OnCreateSession	Wird ausgelöst, wenn der HTTP-Server eine neue Sitzung erstellen muss, sodass die Anwendung eine benutzerdefinierte TIdHTTPSession-Instanz bereitstellen kann.
OnDisconnect	Wird jedes Mal ausgelöst, wenn eine WebSocket-Verbindung mit einem Client getrennt wird.
OnError	Wird immer dann ausgelöst, wenn ein WebSocket-Protokollfehler auftritt, etwa ein fehlerhafter Handshake.
OnException	Wird ausgelöst, wenn beim Verarbeiten einer Client-Verbindung eine nicht behandelte Ausnahme auftritt.
OnFragmented	Wird ausgelöst, wenn ein Fragment einer Nachricht empfangen wird (nur wenn Options.FragmentedMessages frgAll oder frgOnlyFragmented ist).
OnHandshake	Wird ausgelöst, nachdem der Handshake auf der Serverseite ausgewertet wurde und bevor die Antwort gesendet wird.
OnHTTP2BeforeAsyncRequest	Wird ausgelöst, bevor eine HTTP/2-Anforderung eingereiht wird, sodass die Anwendung wählen kann, ob sie im Thread-Pool oder im Verbindungsthread ausgeführt wird.
OnHTTPUploadAfterSaveFile	Wird ausgelöst, nachdem eine aus einem multipart/form-data-Upload extrahierte Datei auf der Festplatte gespeichert wurde.
OnHTTPUploadBeforeCreatePostStream	Wird ausgelöst, nachdem die Anfrage-Header gelesen wurden und bevor der POST-Stream erstellt wird, sodass der Upload angenommen oder abgelehnt werden kann.
OnHTTPUploadBeforeSaveFile	Wird ausgelöst, bevor eine aus einem multipart/form-data-Upload extrahierte Datei auf die Festplatte gespeichert wird, sodass Name und Pfad angepasst werden können.
OnHTTPUploadReadInput	Wird ausgelöst, wenn der multipart/form-data-Decoder ein Nicht-Datei-Eingabefeld liest, sodass dessen Wert erfasst werden kann.
OnInvalidSession	Wird ausgelöst, wenn eine HTTP-Anfrage eine unbekannte oder abgelaufene Sitzungs-ID präsentiert, sodass die Anwendung entscheiden kann, wie sie reagiert.
OnLoadBalancerConnect	Wird ausgelöst, wenn der Server sich mit dem Load Balancer Server verbindet.
OnLoadBalancerDisconnect	Wird ausgelöst, wenn sich der Server vom Load Balancer Server trennt.
OnLoadBalancerError	Wird ausgelöst, wenn bei der Kommunikation mit dem Load-Balancer-Server ein Fehler auftritt.
OnMessage	Wird jedes Mal ausgelöst, wenn ein Client eine Textnachricht sendet und sie vom Server empfangen wird.
OnSessionEnd	Wird ausgelöst, wenn eine HTTP-Sitzung geschlossen wird, entweder explizit oder nach Ablauf von SessionTimeout.
OnSessionStart	Wird ausgelöst, wenn eine HTTP-Sitzung gestartet und zur SessionList hinzugefügt wird.
OnShutdown	Wird ausgelöst, nachdem der Server gestoppt wurde und keine Verbindungen mehr akzeptiert werden.
OnSSLAfterCreateHandler	Wird ausgelöst, nachdem der SSL-Handler erstellt wurde, sodass seine Eigenschaften angepasst werden können.
OnSSLALPNSelect	Wird während eines ALPN-fähigen Handshakes ausgelöst, sodass die Anwendung auswählen kann, welches Protokoll ausgehandelt werden soll.
OnSSLGetHandler	Wird ausgelöst, bevor der SSL-Handler erstellt wird, sodass eine benutzerdefinierte serverseitige Handler-Instanz bereitgestellt werden kann.
OnSSLVerifyPeer	Wird ausgelöst, wenn VerifyCertificate aktiviert ist und der Client ein Zertifikat zur Annahme oder Ablehnung vorlegt.
OnStartup	Wird ausgelöst, nachdem der Server gestartet wurde und bereit ist, Verbindungen anzunehmen.
OnTCPConnect	Wird ausgelöst, nachdem sich ein Client auf TCP-Ebene verbunden hat und vor dem WebSocket-Handshake, sodass die Verbindung akzeptiert oder abgelehnt werden kann.
OnUnknownAuthentication	Wird ausgelöst, wenn die Authentifizierung aktiviert ist und die Authentifizierungsmethode vom Server nicht erkannt wird.
OnUnknownProtocol	Wird ausgelöst, wenn die erste Nachricht keinem bekannten Protokoll entspricht, sodass die Verbindung akzeptiert oder abgelehnt werden kann.