TsgcHTTP3Server › Ereignisse › OnH3Connect

OnH3Connect Ereignis

Wird ausgelöst, wenn ein Client eine HTTP/3-Verbindung aufbaut.

Syntax

property OnH3Connect: TsgcQUICServerConnectEvent;
// TsgcQUICServerConnectEvent = procedure(Sender: TObject; const aConnection: TsgcQUICServerConnection) of object

Standardwert

—

Parameter

NameTypBeschreibung
SenderTObjectDie TsgcHTTP3Server-Instanz, die das Ereignis ausgelöst hat.
aConnectionconst TsgcQUICServerConnectionNeu hergestellte QUIC-Verbindung. Stellt PeerIP, PeerPort, CreatedAt und den Verbindungszustand bereit. In .NET ist dieser Parameter ein string, der den Peer-Endpunkt enthält und als Verbindungs-ID dient.

Hinweise

OnH3Connect wird ausgelöst, nachdem ein Client den QUIC-Handshake abgeschlossen hat (einschließlich des TLS-1.3-Austauschs und der ALPN-Aushandlung von h3) und der Server die HTTP/3-Control- und QPACK-Streams geöffnet hat, was bedeutet, dass die Verbindung bereit ist, Anfragen zu übertragen. Das Ereignis wird einmal pro Verbindung ausgelöst, vor jedem OnH3Request. Verwenden Sie den Parameter aConnection, um den Peer zu protokollieren oder pro-Verbindung-Kontext zu initialisieren.

Das Ereignis wird auf dem Hintergrund-Listener-Thread des Servers ausgelöst, es darf daher die Benutzeroberfläche nicht direkt anfassen.

Halten Sie die Referenz aConnection nicht über die Lebensdauer der Verbindung hinaus: Sie wird freigegeben, sobald OnH3Disconnect dafür ausgelöst wurde.

Beispiel


procedure OnH3ConnectEvent(Sender: TObject; const aConnection:
    TsgcQUICServerConnection);
begin
  Log('HTTP/3 client connected from ' + aConnection.PeerIP);
end;

Zurück zu Ereignissen