TsgcWSPClient_MQTT › Événements › OnMQTTBeforeConnect

OnMQTTBeforeConnect Événement

Se déclenche avant l'envoi du paquet CONNECT ; permet à l'application de remplacer CleanSession et ClientIdentifier.

Syntaxe

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

Valeur par défaut

—

Remarques

Dernière chance de modifier le paquet CONNECT juste avant son écriture sur le réseau. Le composant déclenche cet événement après que le transport WebSocket / TCP est opérationnel mais avant la sérialisation de CONNECT, afin que le gestionnaire puisse remplacer :

• aCleanSession (var, Boolean) — lorsque True (par défaut), le broker supprime toute session précédente et repart à zéro ; définissez False pour reprendre une session stockée (MQTT 5 expose cela plus finement via SessionExpiryInterval sur ConnectProperties).
• aClientIdentifier (var, String) — l'identifiant client unique. Le composant génère automatiquement une valeur basée sur un GUID ; remplacez-la ici si votre broker exige un identifiant spécifique (par exemple pour correspondre à une règle de contrôle d'accès ou pour se reconnecter et reprendre une session persistante).

Tout autre état de connexion (credentials, LastWillTestament, ConnectProperties) doit être configuré sur le composant lui-même avant Activate, et non à l'intérieur de ce gestionnaire.

Exemple

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;

Retour aux événements