OnUnknownProtocol Zdarzenie

Wywoływane, gdy pierwsza wiadomość nie pasuje do żadnego ze znanych protokołów, dzięki czemu połączenie może zostać zaakceptowane lub odrzucone.

Składnia

property OnUnknownProtocol: TsgcWSUnknownProtocolEvent;
// TsgcWSUnknownProtocolEvent = procedure(Connection: TsgcWSConnection; var Accept: Boolean) of object

Wartość domyślna

—

Uwagi

OnUnknownProtocol jest wywoływane, gdy serwer odbiera pierwsze bajty od łączącego się klienta i nie może rozpoznać żadnego z wbudowanych protokołów (WebSocket, HTTP, SSE itp.). Zazwyczaj jest używane do akceptowania zwykłych klientów TCP na tym samym nasłuchiwarce, który obsługuje HTTP. Ustaw Accept na True, aby utrzymać sesję otwartą (zdarzenie OnConnect zostanie wtedy wywołane jako zwykłe połączenie TCP), lub False, aby ją zamknąć. Parametr Connection identyfikuje sesję; w celu podjęcia decyzji o zezwoleniu na połączenie należy sprawdzić właściwość TsgcWSConnection.Transport lub surowe bajty już zbuforowane. Niechciane połączenia można tu odrzucać, aby zmniejszyć obciążenie procesora.

Przykład


procedure OnUnknownProtocol(Connection: TsgcWSConnection; var Accept: Boolean);
begin
  Accept := True;
end;

Powrót do Zdarzeń