TsgcHTTPServer › Événements

Événements TsgcHTTPServer

É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 l'analyse de la requête HTTP, de sorte que la connexion peut être acceptée ou rejetée.
OnConnect	Se déclenche chaque fois qu'une connexion cliente est établie.
OnDisconnect	Se déclenche chaque fois qu'une connexion cliente est interrompue.
OnError	Se déclenche chaque fois qu'une erreur de niveau protocole se produit lors du traitement d'une connexion cliente.
OnException	Se déclenche chaque fois qu'une exception non gérée est levée lors du traitement d'une connexion cliente.
OnUnknownProtocol	Se déclenche lorsque les premiers octets reçus ne ressemblent pas à une requête HTTP valide, 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.

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	Se déclenche 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
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.

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	Se déclenche lors d'un handshake avec 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.
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 cliente est établie.
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 cliente est interrompue.
OnError	Se déclenche chaque fois qu'une erreur de niveau protocole se produit lors du traitement d'une connexion cliente.
OnException	Se déclenche chaque fois qu'une exception non gérée est levée lors du traitement d'une connexion cliente.
OnHTTP2BeforeAsyncRequest	Se déclenche 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.
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.
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	Se déclenche lors d'un handshake avec 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 l'analyse de la requête HTTP, 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 les premiers octets reçus ne ressemblent pas à une requête HTTP valide, afin que la connexion puisse être acceptée ou rejetée.