Événements TsgcWebSocketHTTPServer

Événements que vous pouvez gérer, regroupés par objectif, suivis de la liste alphabétique complète.

Cycle de vie

Nom	Description
OnStartup	Se déclenche après que le serveur a démarré et est prêt à accepter des connexions.
OnShutdown	Se déclenche après l'arrêt du serveur, lorsqu'aucune connexion supplémentaire n'est acceptée.
OnTCPConnect	Se déclenche après la connexion d'un client au niveau TCP et avant le handshake WebSocket, de sorte que la connexion peut être acceptée ou rejetée.
OnConnect	Se déclenche chaque fois qu'une connexion WebSocket est établie avec un client.
OnDisconnect	Se déclenche chaque fois qu'une connexion WebSocket avec un client est interrompue.
OnHandshake	Se déclenche après que la handshake a été évaluée côté serveur et avant l'envoi de la réponse.
OnError	Se déclenche chaque fois qu'une erreur de protocole WebSocket se produit, par exemple lors d'un handshake mal formé.
OnException	Se déclenche chaque fois qu'une exception non gérée est levée lors du traitement d'une connexion client.
OnUnknownProtocol	Se déclenche lorsque le premier message ne correspond à aucun protocole connu afin que la connexion puisse être acceptée ou rejetée.
OnUnknownAuthentication	Se déclenche lorsque l'authentification est activée et que la méthode d'authentification n'est pas reconnue par le serveur.

Données

Nom	Description
OnMessage	Se déclenche chaque fois qu'un client envoie un message texte et qu'il est reçu par le serveur.
OnBinary	Se déclenche chaque fois qu'un client envoie un message binaire reçu par le serveur.
OnFragmented	Se déclenche lorsqu'un fragment de message est reçu (uniquement lorsque Options.FragmentedMessages est frgAll ou frgOnlyFragmented).

HTTP

Nom	Description
OnBeforeCommand	Se déclenche avant OnCommandGet ou OnCommandOther afin que la requête puisse être examinée, autorisée ou court-circuitée avec une réponse 401.
OnCommandGet	Se déclenche lorsque le serveur HTTP reçoit une requête GET, POST ou HEAD afin que l'application puisse construire la réponse.
OnCommandOther	Se déclenche lorsque le serveur HTTP reçoit une méthode autre que GET, POST ou HEAD (PUT, DELETE, OPTIONS, PATCH...).
OnBeforeForwardHTTP	Se déclenche avant qu'une requête HTTP soit transmise afin qu'elle puisse être transférée (proxy inverse) vers un autre serveur HTTP.
OnAfterForwardHTTP	Se déclenche après qu'une requête HTTP a été transférée afin que l'application puisse inspecter le résultat ou une erreur renvoyée par le serveur en amont.
OnHTTP2BeforeAsyncRequest	Déclenché avant qu'une requête HTTP/2 ne soit mise en file d'attente, afin que l'application puisse choisir si elle s'exécute dans le pool de threads ou dans le thread de connexion.

Sessions

Nom	Description
OnCreateSession	Se déclenche lorsque le serveur HTTP a besoin de créer une nouvelle session afin que l'application puisse fournir une instance TIdHTTPSession personnalisée.
OnSessionStart	Se déclenche lorsqu'une session HTTP est démarrée et ajoutée à la SessionList.
OnSessionEnd	Se déclenche lorsqu'une session HTTP est fermée, explicitement ou après expiration de SessionTimeout.
OnInvalidSession	Se déclenche lorsqu'une requête HTTP présente un ID de session inconnu ou expiré afin que l'application puisse décider comment réagir.

Téléversement HTTP

Nom	Description
OnHTTPUploadBeforeSaveFile	Se déclenche avant qu'un fichier extrait d'un téléchargement multipart/form-data soit sauvegardé sur disque afin que le nom et le chemin puissent être personnalisés.
OnHTTPUploadAfterSaveFile	Se déclenche après qu'un fichier extrait d'un upload multipart/form-data a été sauvegardé sur disque.
OnHTTPUploadReadInput	Se déclenche lorsque le décodeur multipart/form-data lit un champ de saisie non-fichier afin que sa valeur puisse être capturée.
OnHTTPUploadBeforeCreatePostStream	Se déclenche après la lecture des en-têtes de la requête et avant la création du flux POST, afin que le chargement puisse être accepté ou rejeté.

Fiabilité

Nom	Description
OnBeforeHeartBeat	Se déclenche avant chaque ping HeartBeat afin que l'application puisse implémenter un keep-alive personnalisé.
OnLoadBalancerConnect	Se déclenche lorsque le serveur se connecte au serveur Load Balancer.
OnLoadBalancerDisconnect	Se déclenche lorsque le serveur se déconnecte du serveur Load Balancer.
OnLoadBalancerError	Se déclenche lorsqu'une erreur survient lors de la communication avec le serveur d'équilibrage de charge.

Sécurité

Nom	Description
OnAuthentication	Se déclenche lorsque l'authentification est activée afin que l'application puisse vérifier le nom d'utilisateur et le mot de passe et accepter ou rejeter la connexion.
OnSSLGetHandler	Se déclenche avant la création du gestionnaire SSL afin qu'une instance de gestionnaire personnalisée côté serveur puisse être fournie.
OnSSLAfterCreateHandler	Se déclenche après la création du gestionnaire SSL afin que ses propriétés puissent être personnalisées.
OnSSLALPNSelect	Déclenché lors d'un handshake ALPN activé afin que l'application puisse choisir le protocole à négocier.
OnSSLVerifyPeer	Se déclenche lorsque VerifyCertificate est activé et que le client présente un certificat à accepter ou à rejeter.

Tous les événements (ordre alphabétique)

Nom	Description
OnAfterForwardHTTP	Se déclenche après qu'une requête HTTP a été transférée afin que l'application puisse inspecter le résultat ou une erreur renvoyée par le serveur en amont.
OnAuthentication	Se déclenche lorsque l'authentification est activée afin que l'application puisse vérifier le nom d'utilisateur et le mot de passe et accepter ou rejeter la connexion.
OnBeforeCommand	Se déclenche avant OnCommandGet ou OnCommandOther afin que la requête puisse être examinée, autorisée ou court-circuitée avec une réponse 401.
OnBeforeForwardHTTP	Se déclenche avant qu'une requête HTTP soit transmise afin qu'elle puisse être transférée (proxy inverse) vers un autre serveur HTTP.
OnBeforeHeartBeat	Se déclenche avant chaque ping HeartBeat afin que l'application puisse implémenter un keep-alive personnalisé.
OnBinary	Se déclenche chaque fois qu'un client envoie un message binaire reçu par le serveur.
OnCommandGet	Se déclenche lorsque le serveur HTTP reçoit une requête GET, POST ou HEAD afin que l'application puisse construire la réponse.
OnCommandOther	Se déclenche lorsque le serveur HTTP reçoit une méthode autre que GET, POST ou HEAD (PUT, DELETE, OPTIONS, PATCH...).
OnConnect	Se déclenche chaque fois qu'une connexion WebSocket est établie avec un client.
OnCreateSession	Se déclenche lorsque le serveur HTTP a besoin de créer une nouvelle session afin que l'application puisse fournir une instance TIdHTTPSession personnalisée.
OnDisconnect	Se déclenche chaque fois qu'une connexion WebSocket avec un client est interrompue.
OnError	Se déclenche chaque fois qu'une erreur de protocole WebSocket se produit, par exemple lors d'un handshake mal formé.
OnException	Se déclenche chaque fois qu'une exception non gérée est levée lors du traitement d'une connexion client.
OnFragmented	Se déclenche lorsqu'un fragment de message est reçu (uniquement lorsque Options.FragmentedMessages est frgAll ou frgOnlyFragmented).
OnHandshake	Se déclenche après que la handshake a été évaluée côté serveur et avant l'envoi de la réponse.
OnHTTP2BeforeAsyncRequest	Déclenché avant qu'une requête HTTP/2 ne soit mise en file d'attente, afin que l'application puisse choisir si elle s'exécute dans le pool de threads ou dans le thread de connexion.
OnHTTPUploadAfterSaveFile	Se déclenche après qu'un fichier extrait d'un upload multipart/form-data a été sauvegardé sur disque.
OnHTTPUploadBeforeCreatePostStream	Se déclenche après la lecture des en-têtes de la requête et avant la création du flux POST, afin que le chargement puisse être accepté ou rejeté.
OnHTTPUploadBeforeSaveFile	Se déclenche avant qu'un fichier extrait d'un téléchargement multipart/form-data soit sauvegardé sur disque afin que le nom et le chemin puissent être personnalisés.
OnHTTPUploadReadInput	Se déclenche lorsque le décodeur multipart/form-data lit un champ de saisie non-fichier afin que sa valeur puisse être capturée.
OnInvalidSession	Se déclenche lorsqu'une requête HTTP présente un ID de session inconnu ou expiré afin que l'application puisse décider comment réagir.
OnLoadBalancerConnect	Se déclenche lorsque le serveur se connecte au serveur Load Balancer.
OnLoadBalancerDisconnect	Se déclenche lorsque le serveur se déconnecte du serveur Load Balancer.
OnLoadBalancerError	Se déclenche lorsqu'une erreur survient lors de la communication avec le serveur d'équilibrage de charge.
OnMessage	Se déclenche chaque fois qu'un client envoie un message texte et qu'il est reçu par le serveur.
OnSessionEnd	Se déclenche lorsqu'une session HTTP est fermée, explicitement ou après expiration de SessionTimeout.
OnSessionStart	Se déclenche lorsqu'une session HTTP est démarrée et ajoutée à la SessionList.
OnShutdown	Se déclenche après l'arrêt du serveur, lorsqu'aucune connexion supplémentaire n'est acceptée.
OnSSLAfterCreateHandler	Se déclenche après la création du gestionnaire SSL afin que ses propriétés puissent être personnalisées.
OnSSLALPNSelect	Déclenché lors d'un handshake ALPN activé afin que l'application puisse choisir le protocole à négocier.
OnSSLGetHandler	Se déclenche avant la création du gestionnaire SSL afin qu'une instance de gestionnaire personnalisée côté serveur puisse être fournie.
OnSSLVerifyPeer	Se déclenche lorsque VerifyCertificate est activé et que le client présente un certificat à accepter ou à rejeter.
OnStartup	Se déclenche après que le serveur a démarré et est prêt à accepter des connexions.
OnTCPConnect	Se déclenche après la connexion d'un client au niveau TCP et avant le handshake WebSocket, de sorte que la connexion peut être acceptée ou rejetée.
OnUnknownAuthentication	Se déclenche lorsque l'authentification est activée et que la méthode d'authentification n'est pas reconnue par le serveur.
OnUnknownProtocol	Se déclenche lorsque le premier message ne correspond à aucun protocole connu afin que la connexion puisse être acceptée ou rejetée.