TsgcWebSocketHTTPServer 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 dell'handshake WebSocket, consentendo di accettare o rifiutare la connessione.
OnConnect	Si attiva ogni volta che viene stabilita una connessione WebSocket con un client.
OnDisconnect	Si attiva ogni volta che una connessione WebSocket con un client viene interrotta.
OnHandshake	Viene generato dopo che l'handshake è stato valutato lato server e prima che venga inviata la risposta.
OnError	Si attiva ogni volta che si verifica un errore di protocollo WebSocket, ad esempio un handshake malformato.
OnException	Si attiva ogni volta che viene generata un'eccezione non gestita durante l'elaborazione di una connessione client.
OnUnknownProtocol	Si attiva quando il primo messaggio non corrisponde a un protocollo noto, 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.

Data

Nome	Descrizione
OnMessage	Viene attivato ogni volta che un client invia un messaggio di testo e questo viene ricevuto dal server.
OnBinary	Si attiva ogni volta che un client invia un messaggio binario e questo viene ricevuto dal server.
OnFragmented	Generato quando viene ricevuto un frammento di un messaggio (solo quando Options.FragmentedMessages è frgAll o frgOnlyFragmented).

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
OnBeforeHeartBeat	Si attiva prima di ogni ping HeartBeat in modo che l'applicazione possa implementare un keep-alive personalizzato.
OnLoadBalancerConnect	Viene attivato quando il server si connette al Load Balancer Server.
OnLoadBalancerDisconnect	Si attiva quando il server si disconnette dal Load Balancer Server.
OnLoadBalancerError	Si attiva quando si verifica un errore nella comunicazione con il server Load Balancer.

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.
OnBeforeHeartBeat	Si attiva prima di ogni ping HeartBeat in modo che l'applicazione possa implementare un keep-alive personalizzato.
OnBinary	Si attiva ogni volta che un client invia un messaggio binario e questo viene ricevuto dal server.
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 WebSocket con un 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 WebSocket con un client viene interrotta.
OnError	Si attiva ogni volta che si verifica un errore di protocollo WebSocket, ad esempio un handshake malformato.
OnException	Si attiva ogni volta che viene generata un'eccezione non gestita durante l'elaborazione di una connessione client.
OnFragmented	Generato quando viene ricevuto un frammento di un messaggio (solo quando Options.FragmentedMessages è frgAll o frgOnlyFragmented).
OnHandshake	Viene generato dopo che l'handshake è stato valutato lato server e prima che venga inviata la risposta.
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.
OnLoadBalancerConnect	Viene attivato quando il server si connette al Load Balancer Server.
OnLoadBalancerDisconnect	Si attiva quando il server si disconnette dal Load Balancer Server.
OnLoadBalancerError	Si attiva quando si verifica un errore nella comunicazione con il server Load Balancer.
OnMessage	Viene attivato ogni volta che un client invia un messaggio di testo e questo viene ricevuto dal server.
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 dell'handshake WebSocket, consentendo di accettare o rifiutare la connessione.
OnUnknownAuthentication	Viene attivato quando l'autenticazione è abilitata e il metodo di autenticazione non è riconosciuto dal server.
OnUnknownProtocol	Si attiva quando il primo messaggio non corrisponde a un protocollo noto, in modo che la connessione possa essere accettata o rifiutata.