OnMQTTBeforeConnect Zdarzenie

Wywoływane przed wysłaniem pakietu CONNECT; umożliwia aplikacji nadpisanie właściwości CleanSession i ClientIdentifier.

Składnia

property OnMQTTBeforeConnect: TsgcWSMQTTBeforeConnectEvent;
// TsgcWSMQTTBeforeConnectEvent = procedure(Connection: TsgcWSConnection; var aCleanSession: Boolean; var aClientIdentifier: String) of object

Wartość domyślna

—

Uwagi

Ostatnia szansa na dostosowanie pakietu CONNECT tuż przed jego zapisaniem do sieci. Składnik generuje to zdarzenie po uruchomieniu transportu WebSocket/TCP, ale przed serializacją CONNECT, dzięki czemu procedura obsługi może nadpisać:

aCleanSession (var, Boolean) — gdy wartość wynosi True (domyślnie), broker odrzuca poprzednią sesję i rozpoczyna nową; ustaw False, aby wznowić zapisaną sesję (MQTT 5 udostępnia tę funkcję bardziej szczegółowo za pomocą właściwości SessionExpiryInterval w ConnectProperties).
aClientIdentifier (var, String) — unikalny identyfikator klienta. Komponent automatycznie generuje wartość opartą na GUID; należy ją tu zastąpić, jeśli broker wymaga określonego identyfikatora (np. w celu dopasowania reguły kontroli dostępu lub ponownego połączenia z trwałą sesją).

Wszelkie inne ustawienia połączenia (dane uwierzytelniające, LastWillTestament, ConnectProperties) należy skonfigurować bezpośrednio w komponencie przed wywołaniem Activate, nie wewnątrz tej procedury obsługi.

Przykład

procedure TForm1.MQTTBeforeConnect(Connection: TsgcWSConnection;
  var aCleanSession: Boolean; var aClientIdentifier: String);
begin
  // resume the stored session if the broker still has it
  aCleanSession     := False;
  aClientIdentifier := 'sensor-gateway-01';
end;

Powrót do Zdarzeń