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

Zdarzenie OnUnknownProtocol jest wywoływane, gdy serwer odbierze pierwsze bajty od łączącego się klienta i nie rozpozna żadnego z wbudowanych protokołów (WebSocket, HTTP, SSE…). Zazwyczaj służy do akceptowania klientów zwykłego TCP. Ustawienie Accept na True powoduje utrzymanie sesji (zdarzenie OnConnect zostanie wtedy wywołane jako zwykłe połączenie TCP), natomiast wartość False powoduje zamknięcie połączenia. Parametr Connection identyfikuje sesję; można sprawdzić właściwość TsgcWSConnection.Transport lub surowe bajty już zbuforowane, aby zdecydować, czy zezwolić na połączenie.

Przykład


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

Powrót do Zdarzeń