TsgcHTTPServer Eventi

Eventi gestibili, raggruppati per scopo, seguiti dall'elenco alfabetico completo.

Ciclo di vita

Nome	Descrizione
OnStartup	Si attiva dopo che il server è avviato ed è pronto ad accettare connessioni.
OnShutdown	Si attiva dopo che il server si è arrestato e non vengono più accettate connessioni.
OnTCPConnect	Si attiva dopo che un client si connette a livello TCP e prima che la richiesta HTTP venga analizzata, in modo che la connessione possa essere accettata o rifiutata.
OnConnect	Si attiva ogni volta che viene stabilita una connessione client.
OnDisconnect	Si attiva ogni volta che una connessione client viene interrotta.
OnError	Si attiva ogni volta che si verifica un errore a livello di protocollo durante l'elaborazione di una connessione client.
OnException	Si attiva ogni volta che viene generata un'eccezione non gestita durante l'elaborazione di una connessione client.
OnUnknownProtocol	Si attiva quando i primi byte ricevuti non sembrano una richiesta HTTP valida, in modo che la connessione possa essere accettata o rifiutata.
OnUnknownAuthentication	Viene attivato quando l'autenticazione è abilitata e il metodo di autenticazione non è riconosciuto dal server.

HTTP

Nome	Descrizione
OnBeforeCommand	Si attiva prima di OnCommandGet o OnCommandOther in modo che la richiesta possa essere filtrata, autorizzata o interrotta con una risposta 401.
OnCommandGet	Viene attivato quando il server HTTP riceve una richiesta GET, POST o HEAD affinché l'applicazione possa costruire la risposta.
OnCommandOther	Generato quando il server HTTP riceve un metodo diverso da GET, POST o HEAD (PUT, DELETE, OPTIONS, PATCH...).
OnBeforeForwardHTTP	Si attiva prima che una richiesta HTTP venga inviata, in modo da poterla inoltrare (reverse-proxy) a un altro server HTTP.
OnAfterForwardHTTP	Viene attivato dopo che una richiesta HTTP è stata inoltrata, consentendo all'applicazione di ispezionare il risultato o un errore restituito dal server upstream.
OnHTTP2BeforeAsyncRequest	Viene generato prima che una richiesta HTTP/2 venga accodata, consentendo all'applicazione di scegliere se eseguirla nel pool di thread o nel thread di connessione.

Sessioni

Nome	Descrizione
OnCreateSession	Generato quando il server HTTP deve creare una nuova sessione, in modo che l'applicazione possa fornire un'istanza personalizzata di TIdHTTPSession.
OnSessionStart	Si attiva quando una sessione HTTP viene avviata e aggiunta alla SessionList.
OnSessionEnd	Si attiva quando una sessione HTTP viene chiusa, esplicitamente o dopo la scadenza di SessionTimeout.
OnInvalidSession	Viene generato quando una richiesta HTTP presenta un ID di sessione sconosciuto o scaduto, in modo che l'applicazione possa decidere come reagire.

HTTP Upload

Nome	Descrizione
OnHTTPUploadBeforeSaveFile	Si attiva prima che un file estratto da un upload multipart/form-data venga salvato su disco, in modo che il nome e il percorso possano essere personalizzati.
OnHTTPUploadAfterSaveFile	Generato dopo che un file estratto da un upload multipart/form-data è stato salvato su disco.
OnHTTPUploadReadInput	Si attiva quando il decoder multipart/form-data legge un campo di input non file in modo che il suo valore possa essere catturato.
OnHTTPUploadBeforeCreatePostStream	Viene generato dopo che le intestazioni della richiesta sono state lette e prima che venga creato lo stream POST, consentendo di accettare o rifiutare il caricamento.

Affidabilità

Nome	Descrizione
OnSendBufferFull	Si attiva quando la coda in uscita di una connessione client ha raggiunto il limite configurato, prima che venga applicata la politica di overflow.

Sicurezza

Nome	Descrizione
OnAuthentication	Si attiva quando l'autenticazione è abilitata in modo che l'applicazione possa verificare utente e password e accettare o rifiutare la connessione.
OnSSLGetHandler	Viene generato prima della creazione dell'SSL handler, in modo da poter fornire un'istanza di handler personalizzata lato server.
OnSSLAfterCreateHandler	Si attiva dopo che l'handler SSL è stato creato, così le sue proprietà possono essere personalizzate.
OnSSLALPNSelect	Viene attivato durante un handshake con ALPN abilitato affinché l'applicazione possa scegliere quale protocollo negoziare.
OnSSLVerifyPeer	Si attiva quando VerifyCertificate è abilitato e il client presenta un certificato da accettare o rifiutare.

Tutti gli eventi (in ordine alfabetico)

Nome	Descrizione
OnAfterForwardHTTP	Viene attivato dopo che una richiesta HTTP è stata inoltrata, consentendo all'applicazione di ispezionare il risultato o un errore restituito dal server upstream.
OnAuthentication	Si attiva quando l'autenticazione è abilitata in modo che l'applicazione possa verificare utente e password e accettare o rifiutare la connessione.
OnBeforeCommand	Si attiva prima di OnCommandGet o OnCommandOther in modo che la richiesta possa essere filtrata, autorizzata o interrotta con una risposta 401.
OnBeforeForwardHTTP	Si attiva prima che una richiesta HTTP venga inviata, in modo da poterla inoltrare (reverse-proxy) a un altro server HTTP.
OnCommandGet	Viene attivato quando il server HTTP riceve una richiesta GET, POST o HEAD affinché l'applicazione possa costruire la risposta.
OnCommandOther	Generato quando il server HTTP riceve un metodo diverso da GET, POST o HEAD (PUT, DELETE, OPTIONS, PATCH...).
OnConnect	Si attiva ogni volta che viene stabilita una connessione client.
OnCreateSession	Generato quando il server HTTP deve creare una nuova sessione, in modo che l'applicazione possa fornire un'istanza personalizzata di TIdHTTPSession.
OnDisconnect	Si attiva ogni volta che una connessione client viene interrotta.
OnError	Si attiva ogni volta che si verifica un errore a livello di protocollo durante l'elaborazione di una connessione client.
OnException	Si attiva ogni volta che viene generata un'eccezione non gestita durante l'elaborazione di una connessione client.
OnHTTP2BeforeAsyncRequest	Viene generato prima che una richiesta HTTP/2 venga accodata, consentendo all'applicazione di scegliere se eseguirla nel pool di thread o nel thread di connessione.
OnHTTPUploadAfterSaveFile	Generato dopo che un file estratto da un upload multipart/form-data è stato salvato su disco.
OnHTTPUploadBeforeCreatePostStream	Viene generato dopo che le intestazioni della richiesta sono state lette e prima che venga creato lo stream POST, consentendo di accettare o rifiutare il caricamento.
OnHTTPUploadBeforeSaveFile	Si attiva prima che un file estratto da un upload multipart/form-data venga salvato su disco, in modo che il nome e il percorso possano essere personalizzati.
OnHTTPUploadReadInput	Si attiva quando il decoder multipart/form-data legge un campo di input non file in modo che il suo valore possa essere catturato.
OnInvalidSession	Viene generato quando una richiesta HTTP presenta un ID di sessione sconosciuto o scaduto, in modo che l'applicazione possa decidere come reagire.
OnSendBufferFull	Si attiva quando la coda in uscita di una connessione client ha raggiunto il limite configurato, prima che venga applicata la politica di overflow.
OnSessionEnd	Si attiva quando una sessione HTTP viene chiusa, esplicitamente o dopo la scadenza di SessionTimeout.
OnSessionStart	Si attiva quando una sessione HTTP viene avviata e aggiunta alla SessionList.
OnShutdown	Si attiva dopo che il server si è arrestato e non vengono più accettate connessioni.
OnSSLAfterCreateHandler	Si attiva dopo che l'handler SSL è stato creato, così le sue proprietà possono essere personalizzate.
OnSSLALPNSelect	Viene attivato durante un handshake con ALPN abilitato affinché l'applicazione possa scegliere quale protocollo negoziare.
OnSSLGetHandler	Viene generato prima della creazione dell'SSL handler, in modo da poter fornire un'istanza di handler personalizzata lato server.
OnSSLVerifyPeer	Si attiva quando VerifyCertificate è abilitato e il client presenta un certificato da accettare o rifiutare.
OnStartup	Si attiva dopo che il server è avviato ed è pronto ad accettare connessioni.
OnTCPConnect	Si attiva dopo che un client si connette a livello TCP e prima che la richiesta HTTP venga analizzata, in modo che la connessione possa essere accettata o rifiutata.
OnUnknownAuthentication	Viene attivato quando l'autenticazione è abilitata e il metodo di autenticazione non è riconosciuto dal server.
OnUnknownProtocol	Si attiva quando i primi byte ricevuti non sembrano una richiesta HTTP valida, in modo che la connessione possa essere accettata o rifiutata.