TsgcHTTP3Server › Methoden › Start

Start Methode

Startet den QUIC-Listener und beginnt, HTTP/3-Verbindungen anzunehmen.

Syntax

procedure Start;

Hinweise

Start lädt OpenSSL, erstellt den QUIC-Serverkontext aus dem Zertifikat und dem privaten Schlüssel in QUICOptions.SSLOptions, bindet einen UDP-Socket an Port und startet den Hintergrund-Listener-Thread, der Verbindungen annimmt, die QUIC-Ereignisschleife bedient und OnH3Request auslöst. OnStartup wird ausgelöst, sobald der Listener bereit ist.

Start entspricht dem Setzen von Active auf True und kehrt zurück, sobald der Listener läuft: Verbindungen werden auf dem Hintergrund-Thread bedient, nicht durch diesen Aufruf. Der Aufruf von Start auf einem bereits laufenden Server bewirkt nichts.

Alles, was der Listener liest, muss vorher konfiguriert werden: Port, das Zertifikat und der Schlüssel sowie alle H3Settings, die Sie den Clients ankündigen möchten. Zertifikat und Schlüssel sind zwingend erforderlich, weil QUIC immer TLS 1.3 verwendet; wenn eines von beiden fehlt, nicht lesbar ist oder beide nicht zusammenpassen, löst Start eine Ausnahme aus.

Der Transport ist die QUIC-Engine, die in OpenSSL 3.5 oder neuer eingebaut ist und die der Server direkt für seinen Listener verwendet. Es gibt keinen Fallback: Ein älteres OpenSSL besitzt keine QUIC-Listener-API, Start schlägt damit also fehl. Rufen Sie Stop auf, um den Server herunterzufahren.

Diese Methode wird von TsgcQUICServer geerbt.

Beispiel


oServer := TsgcHTTP3Server.Create(nil);
oServer.Port := 443;
oServer.QUICOptions.SSLOptions.CertFile := 'cert.pem';
oServer.QUICOptions.SSLOptions.KeyFile := 'key.pem';
oServer.OnH3Request := OnH3RequestEvent;
oServer.Start;

Zurück zu Methoden