TsgcHTTPServer Eventos

Eventos que puede gestionar, agrupados por propósito, seguidos de la lista alfabética completa.

Ciclo de Vida

Nombre	Descripción
OnStartup	Se activa después de que el servidor se ha iniciado y está listo para aceptar conexiones.
OnShutdown	Se activa después de que el servidor se ha detenido y ya no se aceptan más conexiones.
OnTCPConnect	Se activa después de que un cliente se conecta a nivel TCP y antes de que se analice la solicitud HTTP, para que la conexión pueda aceptarse o rechazarse.
OnConnect	Se dispara cada vez que se establece una conexión con un cliente.
OnDisconnect	Se activa cada vez que se interrumpe una conexión con un cliente.
OnError	Se activa cuando se produce un error a nivel de protocolo al procesar una conexión de cliente.
OnException	Se activa cuando se produce una excepción no controlada al procesar una conexión de cliente.
OnUnknownProtocol	Se activa cuando los primeros bytes recibidos no parecen una solicitud HTTP válida, de modo que la conexión puede aceptarse o rechazarse.
OnUnknownAuthentication	Se activa cuando la autenticación está habilitada y el servidor no reconoce el método de autenticación.

HTTP

Nombre	Descripción
OnBeforeCommand	Se activa antes de OnCommandGet o OnCommandOther para que la solicitud pueda ser examinada, autorizada o cortocircuitada con una respuesta 401.
OnCommandGet	Se activa cuando el servidor HTTP recibe una solicitud GET, POST o HEAD para que la aplicación pueda construir la respuesta.
OnCommandOther	Se activa cuando el servidor HTTP recibe un método distinto de GET, POST o HEAD (PUT, DELETE, OPTIONS, PATCH...).
OnBeforeForwardHTTP	Se activa antes de que se despache una solicitud HTTP para que pueda reenviarse (proxy inverso) a otro servidor HTTP.
OnAfterForwardHTTP	Se dispara después de que se haya reenviado una solicitud HTTP para que la aplicación pueda inspeccionar el resultado o un error devuelto por el servidor ascendente.
OnHTTP2BeforeAsyncRequest	Se activa antes de que una solicitud HTTP/2 se ponga en cola, para que la aplicación pueda decidir si se ejecuta en el grupo de hilos o en el hilo de conexión.

Sesiones

Nombre	Descripción
OnCreateSession	Se activa cuando el servidor HTTP necesita crear una nueva sesión para que la aplicación pueda proporcionar una instancia personalizada de TIdHTTPSession.
OnSessionStart	Se activa cuando se inicia una sesión HTTP y se añade a la lista SessionList.
OnSessionEnd	Se activa cuando se cierra una sesión HTTP, ya sea de forma explícita o tras expirar SessionTimeout.
OnInvalidSession	Se activa cuando una solicitud HTTP presenta un ID de sesión desconocido o caducado para que la aplicación pueda decidir cómo reaccionar.

Carga HTTP

Nombre	Descripción
OnHTTPUploadBeforeSaveFile	Se activa antes de que un archivo extraído de una carga multipart/form-data se guarde en disco para que el nombre y la ruta puedan personalizarse.
OnHTTPUploadAfterSaveFile	Se activa después de que un archivo extraído de una carga multipart/form-data ha sido guardado en disco.
OnHTTPUploadReadInput	Se activa cuando el decodificador multipart/form-data lee un campo de entrada que no es un archivo, para que su valor pueda capturarse.
OnHTTPUploadBeforeCreatePostStream	Se activa después de que se han leído las cabeceras de la solicitud y antes de que se cree el stream POST, de modo que la carga puede aceptarse o rechazarse.

Fiabilidad

Nombre	Descripción
OnSendBufferFull	Se activa cuando la cola de salida de una conexión de cliente ha alcanzado su límite configurado, antes de que se aplique la política de desbordamiento.

Seguridad

Nombre	Descripción
OnAuthentication	Se activa cuando la autenticación está habilitada para que la aplicación pueda verificar el usuario y la contraseña y aceptar o rechazar la conexión.
OnSSLGetHandler	Se activa antes de que se cree el controlador SSL, lo que permite proporcionar una instancia de controlador personalizado del lado del servidor.
OnSSLAfterCreateHandler	Se activa después de que el controlador SSL ha sido creado para que sus propiedades puedan personalizarse.
OnSSLALPNSelect	Se activa durante un handshake con ALPN habilitado para que la aplicación pueda elegir qué protocolo negociar.
OnSSLVerifyPeer	Se activa cuando VerifyCertificate está habilitado y el cliente presenta un certificado para ser aceptado o rechazado.

Todos los eventos (orden alfabético)

Nombre	Descripción
OnAfterForwardHTTP	Se dispara después de que se haya reenviado una solicitud HTTP para que la aplicación pueda inspeccionar el resultado o un error devuelto por el servidor ascendente.
OnAuthentication	Se activa cuando la autenticación está habilitada para que la aplicación pueda verificar el usuario y la contraseña y aceptar o rechazar la conexión.
OnBeforeCommand	Se activa antes de OnCommandGet o OnCommandOther para que la solicitud pueda ser examinada, autorizada o cortocircuitada con una respuesta 401.
OnBeforeForwardHTTP	Se activa antes de que se despache una solicitud HTTP para que pueda reenviarse (proxy inverso) a otro servidor HTTP.
OnCommandGet	Se activa cuando el servidor HTTP recibe una solicitud GET, POST o HEAD para que la aplicación pueda construir la respuesta.
OnCommandOther	Se activa cuando el servidor HTTP recibe un método distinto de GET, POST o HEAD (PUT, DELETE, OPTIONS, PATCH...).
OnConnect	Se dispara cada vez que se establece una conexión con un cliente.
OnCreateSession	Se activa cuando el servidor HTTP necesita crear una nueva sesión para que la aplicación pueda proporcionar una instancia personalizada de TIdHTTPSession.
OnDisconnect	Se activa cada vez que se interrumpe una conexión con un cliente.
OnError	Se activa cuando se produce un error a nivel de protocolo al procesar una conexión de cliente.
OnException	Se activa cuando se produce una excepción no controlada al procesar una conexión de cliente.
OnHTTP2BeforeAsyncRequest	Se activa antes de que una solicitud HTTP/2 se ponga en cola, para que la aplicación pueda decidir si se ejecuta en el grupo de hilos o en el hilo de conexión.
OnHTTPUploadAfterSaveFile	Se activa después de que un archivo extraído de una carga multipart/form-data ha sido guardado en disco.
OnHTTPUploadBeforeCreatePostStream	Se activa después de que se han leído las cabeceras de la solicitud y antes de que se cree el stream POST, de modo que la carga puede aceptarse o rechazarse.
OnHTTPUploadBeforeSaveFile	Se activa antes de que un archivo extraído de una carga multipart/form-data se guarde en disco para que el nombre y la ruta puedan personalizarse.
OnHTTPUploadReadInput	Se activa cuando el decodificador multipart/form-data lee un campo de entrada que no es un archivo, para que su valor pueda capturarse.
OnInvalidSession	Se activa cuando una solicitud HTTP presenta un ID de sesión desconocido o caducado para que la aplicación pueda decidir cómo reaccionar.
OnSendBufferFull	Se activa cuando la cola de salida de una conexión de cliente ha alcanzado su límite configurado, antes de que se aplique la política de desbordamiento.
OnSessionEnd	Se activa cuando se cierra una sesión HTTP, ya sea de forma explícita o tras expirar SessionTimeout.
OnSessionStart	Se activa cuando se inicia una sesión HTTP y se añade a la lista SessionList.
OnShutdown	Se activa después de que el servidor se ha detenido y ya no se aceptan más conexiones.
OnSSLAfterCreateHandler	Se activa después de que el controlador SSL ha sido creado para que sus propiedades puedan personalizarse.
OnSSLALPNSelect	Se activa durante un handshake con ALPN habilitado para que la aplicación pueda elegir qué protocolo negociar.
OnSSLGetHandler	Se activa antes de que se cree el controlador SSL, lo que permite proporcionar una instancia de controlador personalizado del lado del servidor.
OnSSLVerifyPeer	Se activa cuando VerifyCertificate está habilitado y el cliente presenta un certificado para ser aceptado o rechazado.
OnStartup	Se activa después de que el servidor se ha iniciado y está listo para aceptar conexiones.
OnTCPConnect	Se activa después de que un cliente se conecta a nivel TCP y antes de que se analice la solicitud HTTP, para que la conexión pueda aceptarse o rechazarse.
OnUnknownAuthentication	Se activa cuando la autenticación está habilitada y el servidor no reconoce el método de autenticación.
OnUnknownProtocol	Se activa cuando los primeros bytes recibidos no parecen una solicitud HTTP válida, de modo que la conexión puede aceptarse o rechazarse.