TsgcWSPClient_MQTT › Eventi › OnMQTTBeforeConnect

OnMQTTBeforeConnect Evento

Si attiva prima dell'invio del pacchetto CONNECT; consente all'app di sovrascrivere CleanSession e ClientIdentifier.

Sintassi

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

Valore predefinito

—

Note

Ultima possibilità di modificare il pacchetto CONNECT appena prima che venga scritto sul wire. Il componente genera questo evento dopo che il trasporto WebSocket/TCP è attivo ma prima della serializzazione di CONNECT, in modo che il gestore possa sovrascrivere:

• aCleanSession (var, Boolean) — quando è True (predefinito) il broker scarta qualsiasi sessione precedente e ne avvia una nuova; impostare su False per riprendere una sessione memorizzata (MQTT 5 espone questo in modo più granulare tramite SessionExpiryInterval su ConnectProperties).
• aClientIdentifier (var, String) — l'identificatore univoco del client. Il componente genera automaticamente un valore basato su GUID; sostituirlo qui se il broker richiede un id specifico (ad esempio per corrispondere a una regola di controllo degli accessi o per riconnettersi e riprendere una sessione persistente).

Qualsiasi altro stato della connessione (credenziali, LastWillTestament, ConnectProperties) deve essere configurato sul componente stesso prima di Activate, non all'interno di questo handler.

Esempio

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;

Torna agli Eventi