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
| Name | Beschreibung |
| OnQUICConnect | Eine Verbindung wurde angenommen und der erste Stream des Peers ist bereit, sodass aus dem Handler heraus sicher geschrieben werden kann. |
| OnQUICDisconnect | Eine Verbindung wurde geschlossen. Wird nicht für Verbindungen ausgelöst, die durch Stop getrennt wurden. |
Data
| Name | Beschreibung |
| OnQUICData | Bytes, die auf dem Standard-QUIC-Stream der Verbindung empfangen wurden. |
| OnQUICStreamData | Bytes, die auf einem beliebigen anderen Stream empfangen werden, versehen mit dessen Stream-ID. Öffentlich, nicht veröffentlicht. Erfordert AlwaysMultiStream. Nur Delphi. |
Errors
| Name | Beschreibung |
| OnQUICException | Der 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)
| Name | Beschreibung |
| OnStartup | Von der UDP-Basis geerbt. Wird von Start ausgelöst, sobald der Listener gebunden ist und annimmt. |
| OnShutdown | Von der UDP-Basis geerbt. Wird von Stop ausgelöst, sobald der Listener und jede Verbindung freigegeben wurden. |
Alle Ereignisse (alphabetisch)
| Name | Beschreibung |
| OnQUICConnect | Wird ausgelöst, wenn eine neue QUIC-Verbindung angenommen wurde und ihr erster Stream bereit ist. |
| OnQUICData | Wird ausgelöst, wenn Anwendungsdaten von einem Peer über dessen Standard-QUIC-Stream empfangen werden. |
| OnQUICDisconnect | Wird ausgelöst, wenn eine QUIC-Verbindung geschlossen wurde, und meldet den Fehlercode und den Grund. |
| OnQUICException | Wird ausgelöst, wenn beim Bedienen der QUIC-Ereignisschleife eine Ausnahme abgefangen wird. |
| OnQUICStreamData | Wird mit Bytes ausgelöst, die von einem zusätzlichen QUIC-Stream gelesen wurden, versehen mit dessen Stream-ID. |
| OnShutdown | Geerbte Benachrichtigung über das Anhalten des Servers. Wird ausgelöst, wenn der Server nicht mehr lauscht und seine Ressourcen freigegeben hat. |
| OnStartup | Geerbte 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.