TsgcWebSocketHTTPServer 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 del handshake de WebSocket, para que la conexión pueda aceptarse o rechazarse.
OnConnect	Se dispara cada vez que se establece una conexión WebSocket con un cliente.
OnDisconnect	Se activa cada vez que se interrumpe una conexión WebSocket con un cliente.
OnHandshake	Se dispara después de que el handshake sea evaluado en el lado del servidor y antes de que se envíe la respuesta.
OnError	Se activa cuando se produce un error de protocolo WebSocket, como un handshake mal formado.
OnException	Se activa cuando se produce una excepción no controlada al procesar una conexión de cliente.
OnUnknownProtocol	Se activa cuando el primer mensaje no coincide con ningún protocolo conocido, 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.

Datos

Nombre	Descripción
OnMessage	Se activa cada vez que un cliente envía un mensaje de texto y es recibido por el servidor.
OnBinary	Se activa cada vez que un cliente envía un mensaje binario y el servidor lo recibe.
OnFragmented	Se activa cuando se recibe un fragmento de un mensaje (solo cuando Options.FragmentedMessages es frgAll o frgOnlyFragmented).

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
OnBeforeHeartBeat	Se activa antes de cada ping de HeartBeat para que la aplicación pueda implementar un keep-alive personalizado.
OnLoadBalancerConnect	Se activa cuando el servidor se conecta al servidor de balanceo de carga.
OnLoadBalancerDisconnect	Se activa cuando el servidor se desconecta del servidor Load Balancer.
OnLoadBalancerError	Se activa cuando se produce un error al comunicarse con el servidor del balanceador de carga.

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.
OnBeforeHeartBeat	Se activa antes de cada ping de HeartBeat para que la aplicación pueda implementar un keep-alive personalizado.
OnBinary	Se activa cada vez que un cliente envía un mensaje binario y el servidor lo recibe.
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 WebSocket 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 WebSocket con un cliente.
OnError	Se activa cuando se produce un error de protocolo WebSocket, como un handshake mal formado.
OnException	Se activa cuando se produce una excepción no controlada al procesar una conexión de cliente.
OnFragmented	Se activa cuando se recibe un fragmento de un mensaje (solo cuando Options.FragmentedMessages es frgAll o frgOnlyFragmented).
OnHandshake	Se dispara después de que el handshake sea evaluado en el lado del servidor y antes de que se envíe la respuesta.
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.
OnLoadBalancerConnect	Se activa cuando el servidor se conecta al servidor de balanceo de carga.
OnLoadBalancerDisconnect	Se activa cuando el servidor se desconecta del servidor Load Balancer.
OnLoadBalancerError	Se activa cuando se produce un error al comunicarse con el servidor del balanceador de carga.
OnMessage	Se activa cada vez que un cliente envía un mensaje de texto y es recibido por el servidor.
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 del handshake de WebSocket, 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 el primer mensaje no coincide con ningún protocolo conocido, de modo que la conexión puede aceptarse o rechazarse.