Eventos do TsgcWebSocketHTTPServer

Eventos que você pode tratar, agrupados por propósito, seguidos pela lista alfabética completa.

Ciclo de Vida

Name	Descrição
OnStartup	Disparado após o servidor ter iniciado e estar pronto para aceitar conexões.
OnShutdown	Dispara depois que o servidor parou e nenhuma conexão a mais é aceita.
OnTCPConnect	Disparado após um cliente conectar no nível TCP e antes do handshake do WebSocket, de modo que a conexão possa ser aceita ou rejeitada.
OnConnect	Disparado toda vez que uma conexão WebSocket é estabelecida com um cliente.
OnDisconnect	Disparado cada vez que uma conexão WebSocket com um cliente é encerrada.
OnHandshake	Dispara depois que o handshake é avaliado no lado do servidor e antes da resposta ser enviada.
OnError	Disparado sempre que ocorre um erro de protocolo WebSocket, como um handshake malformado.
OnException	Disparado sempre que uma exceção não tratada é gerada ao processar uma conexão de cliente.
OnUnknownProtocol	Disparado quando a primeira mensagem não corresponde a um protocolo conhecido, para que a conexão possa ser aceita ou rejeitada.
OnUnknownAuthentication	Disparado quando a autenticação está habilitada e o método de autenticação não é reconhecido pelo servidor.

Data

Name	Descrição
OnMessage	Dispara toda vez que um cliente envia uma mensagem de texto e ela é recebida pelo servidor.
OnBinary	Disparado toda vez que um cliente envia uma mensagem binária e ela é recebida pelo servidor.
OnFragmented	Disparado quando um fragmento de uma mensagem é recebido (somente quando Options.FragmentedMessages é frgAll ou frgOnlyFragmented).

HTTP

Name	Descrição
OnBeforeCommand	Disparado antes de OnCommandGet ou OnCommandOther, de modo que a requisição possa ser triada, autorizada ou interrompida com uma resposta 401.
OnCommandGet	Disparado quando o servidor HTTP recebe uma requisição GET, POST ou HEAD, para que a aplicação possa construir a resposta.
OnCommandOther	Disparado quando o servidor HTTP recebe um método diferente de GET, POST ou HEAD (PUT, DELETE, OPTIONS, PATCH...).
OnBeforeForwardHTTP	Dispara antes de uma requisição HTTP ser despachada, de modo que ela possa ser encaminhada (reverse-proxy) a outro servidor HTTP.
OnAfterForwardHTTP	Disparado após uma requisição HTTP ter sido encaminhada para que a aplicação possa inspecionar o resultado ou um erro retornado pelo servidor upstream.
OnHTTP2BeforeAsyncRequest	Dispara antes de uma requisição HTTP/2 ser enfileirada para que a aplicação possa escolher se ela é executada no pool de threads ou na thread da conexão.

Sessions

Name	Descrição
OnCreateSession	Dispara quando o servidor HTTP precisa criar uma nova sessão, para que a aplicação possa fornecer uma instância TIdHTTPSession personalizada.
OnSessionStart	Disparado quando uma sessão HTTP é iniciada e adicionada à SessionList.
OnSessionEnd	Disparado quando uma sessão HTTP é fechada, seja explicitamente ou após SessionTimeout expirar.
OnInvalidSession	Disparado quando uma requisição HTTP apresenta um ID de sessão desconhecido ou expirado, para que a aplicação possa decidir como reagir.

HTTP Upload

Name	Descrição
OnHTTPUploadBeforeSaveFile	Disparado logo antes de um arquivo extraído de um upload multipart/form-data ser salvo em disco, de modo que o nome e o caminho possam ser personalizados.
OnHTTPUploadAfterSaveFile	Disparado depois que um arquivo extraído de um upload multipart/form-data foi salvo em disco.
OnHTTPUploadReadInput	Disparado quando o decodificador multipart/form-data lê um campo de entrada que não é arquivo, para que seu valor possa ser capturado.
OnHTTPUploadBeforeCreatePostStream	Disparado depois que os headers da requisição foram lidos e antes de o stream POST ser criado, para que o upload possa ser aceito ou rejeitado.

Confiabilidade

Name	Descrição
OnBeforeHeartBeat	Dispara antes de cada ping de HeartBeat para que a aplicação possa implementar um keep-alive personalizado.
OnLoadBalancerConnect	Dispara quando o servidor se conecta ao Load Balancer Server.
OnLoadBalancerDisconnect	Disparado quando o servidor se desconecta do Load Balancer Server.
OnLoadBalancerError	Dispara quando ocorre um erro na comunicação com o Load Balancer Server.

Security

Name	Descrição
OnAuthentication	Dispara quando a autenticação está habilitada para que a aplicação possa verificar usuário e senha e aceitar ou rejeitar a conexão.
OnSSLGetHandler	Disparado antes de o manipulador SSL ser criado, de modo que uma instância de manipulador personalizado do lado do servidor possa ser fornecida.
OnSSLAfterCreateHandler	Dispara depois que o SSL handler foi criado, de modo que suas propriedades possam ser personalizadas.
OnSSLALPNSelect	Disparado durante um handshake com ALPN habilitado, para que a aplicação possa escolher qual protocolo negociar.
OnSSLVerifyPeer	Dispara quando VerifyCertificate está habilitado e o cliente apresenta um certificado a ser aceito ou rejeitado.

Todos os Eventos (alfabético)

Name	Descrição
OnAfterForwardHTTP	Disparado após uma requisição HTTP ter sido encaminhada para que a aplicação possa inspecionar o resultado ou um erro retornado pelo servidor upstream.
OnAuthentication	Dispara quando a autenticação está habilitada para que a aplicação possa verificar usuário e senha e aceitar ou rejeitar a conexão.
OnBeforeCommand	Disparado antes de OnCommandGet ou OnCommandOther, de modo que a requisição possa ser triada, autorizada ou interrompida com uma resposta 401.
OnBeforeForwardHTTP	Dispara antes de uma requisição HTTP ser despachada, de modo que ela possa ser encaminhada (reverse-proxy) a outro servidor HTTP.
OnBeforeHeartBeat	Dispara antes de cada ping de HeartBeat para que a aplicação possa implementar um keep-alive personalizado.
OnBinary	Disparado toda vez que um cliente envia uma mensagem binária e ela é recebida pelo servidor.
OnCommandGet	Disparado quando o servidor HTTP recebe uma requisição GET, POST ou HEAD, para que a aplicação possa construir a resposta.
OnCommandOther	Disparado quando o servidor HTTP recebe um método diferente de GET, POST ou HEAD (PUT, DELETE, OPTIONS, PATCH...).
OnConnect	Disparado toda vez que uma conexão WebSocket é estabelecida com um cliente.
OnCreateSession	Dispara quando o servidor HTTP precisa criar uma nova sessão, para que a aplicação possa fornecer uma instância TIdHTTPSession personalizada.
OnDisconnect	Disparado cada vez que uma conexão WebSocket com um cliente é encerrada.
OnError	Disparado sempre que ocorre um erro de protocolo WebSocket, como um handshake malformado.
OnException	Disparado sempre que uma exceção não tratada é gerada ao processar uma conexão de cliente.
OnFragmented	Disparado quando um fragmento de uma mensagem é recebido (somente quando Options.FragmentedMessages é frgAll ou frgOnlyFragmented).
OnHandshake	Dispara depois que o handshake é avaliado no lado do servidor e antes da resposta ser enviada.
OnHTTP2BeforeAsyncRequest	Dispara antes de uma requisição HTTP/2 ser enfileirada para que a aplicação possa escolher se ela é executada no pool de threads ou na thread da conexão.
OnHTTPUploadAfterSaveFile	Disparado depois que um arquivo extraído de um upload multipart/form-data foi salvo em disco.
OnHTTPUploadBeforeCreatePostStream	Disparado depois que os headers da requisição foram lidos e antes de o stream POST ser criado, para que o upload possa ser aceito ou rejeitado.
OnHTTPUploadBeforeSaveFile	Disparado logo antes de um arquivo extraído de um upload multipart/form-data ser salvo em disco, de modo que o nome e o caminho possam ser personalizados.
OnHTTPUploadReadInput	Disparado quando o decodificador multipart/form-data lê um campo de entrada que não é arquivo, para que seu valor possa ser capturado.
OnInvalidSession	Disparado quando uma requisição HTTP apresenta um ID de sessão desconhecido ou expirado, para que a aplicação possa decidir como reagir.
OnLoadBalancerConnect	Dispara quando o servidor se conecta ao Load Balancer Server.
OnLoadBalancerDisconnect	Disparado quando o servidor se desconecta do Load Balancer Server.
OnLoadBalancerError	Dispara quando ocorre um erro na comunicação com o Load Balancer Server.
OnMessage	Dispara toda vez que um cliente envia uma mensagem de texto e ela é recebida pelo servidor.
OnSessionEnd	Disparado quando uma sessão HTTP é fechada, seja explicitamente ou após SessionTimeout expirar.
OnSessionStart	Disparado quando uma sessão HTTP é iniciada e adicionada à SessionList.
OnShutdown	Dispara depois que o servidor parou e nenhuma conexão a mais é aceita.
OnSSLAfterCreateHandler	Dispara depois que o SSL handler foi criado, de modo que suas propriedades possam ser personalizadas.
OnSSLALPNSelect	Disparado durante um handshake com ALPN habilitado, para que a aplicação possa escolher qual protocolo negociar.
OnSSLGetHandler	Disparado antes de o manipulador SSL ser criado, de modo que uma instância de manipulador personalizado do lado do servidor possa ser fornecida.
OnSSLVerifyPeer	Dispara quando VerifyCertificate está habilitado e o cliente apresenta um certificado a ser aceito ou rejeitado.
OnStartup	Disparado após o servidor ter iniciado e estar pronto para aceitar conexões.
OnTCPConnect	Disparado após um cliente conectar no nível TCP e antes do handshake do WebSocket, de modo que a conexão possa ser aceita ou rejeitada.
OnUnknownAuthentication	Disparado quando a autenticação está habilitada e o método de autenticação não é reconhecido pelo servidor.
OnUnknownProtocol	Disparado quando a primeira mensagem não corresponde a um protocolo conhecido, para que a conexão possa ser aceita ou rejeitada.