TsgcHTTPServer Eventos

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 depois que um cliente conecta no nível TCP e antes de a requisição HTTP ser analisada, para que a conexão possa ser aceita ou rejeitada.
OnConnect	Disparado toda vez que uma conexão de cliente é estabelecida.
OnDisconnect	Disparado toda vez que uma conexão de cliente é encerrada.
OnError	Disparado sempre que ocorre um erro em nível de protocolo ao processar uma conexão de cliente.
OnException	Disparado sempre que uma exceção não tratada é gerada ao processar uma conexão de cliente.
OnUnknownProtocol	Disparado quando os primeiros bytes recebidos não se parecem com uma requisição HTTP válida, 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.

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
OnSendBufferFull	Disparado quando a fila de saída de uma conexão de cliente atinge seu limite configurado, antes de a política de overflow ser aplicada.

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.
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 de cliente é estabelecida.
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 toda vez que uma conexão de cliente é encerrada.
OnError	Disparado sempre que ocorre um erro em nível de protocolo ao processar uma conexão de cliente.
OnException	Disparado sempre que uma exceção não tratada é gerada ao processar uma conexão de cliente.
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.
OnSendBufferFull	Disparado quando a fila de saída de uma conexão de cliente atinge seu limite configurado, antes de a política de overflow ser aplicada.
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 depois que um cliente conecta no nível TCP e antes de a requisição HTTP ser analisada, 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.
OnUnknownProtocol	Disparado quando os primeiros bytes recebidos não se parecem com uma requisição HTTP válida, para que a conexão possa ser aceita ou rejeitada.