TsgcQUICServer › Ereignisse

TsgcQUICServer Ereignisse

Ereignisse, nach Zweck gruppiert, gefolgt von der vollständigen alphabetischen Liste.

Jedes Ereignis wird im Hintergrund-Listener-Thread des Servers ausgelöst, wechseln Sie daher in den Haupt-Thread, bevor Sie die UI ansprechen, und halten Sie die Handler kurz: Die QUIC-Ereignisschleife für alle Verbindungen ist blockiert, während einer läuft. Jeder Handler erhält die zugehörige TsgcQUICServerConnection als Parameter aConnection.

Lebenszyklus der Verbindung

NameBeschreibung
OnQUICConnectEine Verbindung wurde angenommen und der erste Stream des Peers ist bereit, sodass aus dem Handler heraus sicher geschrieben werden kann.
OnQUICDisconnectEine Verbindung wurde geschlossen. Wird nicht für Verbindungen ausgelöst, die durch Stop getrennt wurden.

Data

NameBeschreibung
OnQUICDataBytes, die auf dem Standard-QUIC-Stream der Verbindung empfangen wurden.
OnQUICStreamDataBytes, die auf einem beliebigen anderen Stream empfangen werden, versehen mit dessen Stream-ID. Öffentlich, nicht veröffentlicht. Erfordert AlwaysMultiStream. Nur Delphi.

Errors

NameBeschreibung
OnQUICExceptionDer Listener-Thread hat eine Ausnahme abgefangen. aConnection ist die verursachende Verbindung oder nil bei einem Fehler auf Listener-Ebene. Ausnahmen aus Start kommen hier nicht an.

Server-Lebenszyklus (geerbt)

NameBeschreibung
OnStartupVon der UDP-Basis geerbt. Wird von Start ausgelöst, sobald der Listener gebunden ist und annimmt.
OnShutdownVon der UDP-Basis geerbt. Wird von Stop ausgelöst, sobald der Listener und jede Verbindung freigegeben wurden.

Alle Ereignisse (alphabetisch)

NameBeschreibung
OnQUICConnectWird ausgelöst, wenn eine neue QUIC-Verbindung angenommen wurde und ihr erster Stream bereit ist.
OnQUICDataWird ausgelöst, wenn Anwendungsdaten von einem Peer über dessen Standard-QUIC-Stream empfangen werden.
OnQUICDisconnectWird ausgelöst, wenn eine QUIC-Verbindung geschlossen wurde, und meldet den Fehlercode und den Grund.
OnQUICExceptionWird ausgelöst, wenn beim Bedienen der QUIC-Ereignisschleife eine Ausnahme abgefangen wird.
OnQUICStreamDataWird mit Bytes ausgelöst, die von einem zusätzlichen QUIC-Stream gelesen wurden, versehen mit dessen Stream-ID.
OnShutdownGeerbte Benachrichtigung über das Anhalten des Servers. Wird ausgelöst, wenn der Server nicht mehr lauscht und seine Ressourcen freigegeben hat.
OnStartupGeerbte Benachrichtigung über den Serverstart. Wird ausgelöst, wenn der Server begonnen hat, auf QUIC-Verbindungen zu lauschen.

Verwendung von TsgcHTTP3Server

TsgcHTTP3Server leitet sich von TsgcQUICServer ab und verbindet OnQUICConnect, OnQUICData, OnQUICStreamData und OnQUICDisconnect in seinem Konstruktor mit eigenen Handlern. Werden diese auf einem HTTP/3-Server zugewiesen, ersetzt das die interne Verdrahtung der HTTP/3-Schicht und macht sie unbrauchbar. Verwenden Sie stattdessen die HTTP/3-Ereignisse. OnQUICException ist die Ausnahme: Der HTTP/3-Server beansprucht es nur, wenn Sie es nicht selbst zugewiesen haben.