TsgcWSPClient_MQTT › Eventos › OnMQTTBeforeConnect

OnMQTTBeforeConnect Evento

Se activa antes de que se envíe el paquete CONNECT; permite que la aplicación anule CleanSession y ClientIdentifier.

Sintaxis

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

Valor Predeterminado

—

Observaciones

Última oportunidad para ajustar el paquete CONNECT justo antes de escribirlo en el cable. El componente genera este evento después de que el transporte WebSocket/TCP está activo, pero antes de serializar CONNECT, de modo que el manejador puede invalidar:

• aCleanSession (var, Boolean) — cuando es True (predeterminado), el broker descarta cualquier sesión anterior y comienza desde cero; establézcalo en False para reanudar una sesión almacenada (MQTT 5 expone esto de forma más detallada a través de SessionExpiryInterval en ConnectProperties).
• aClientIdentifier (var, String) — el identificador único del cliente. El componente genera automáticamente un valor basado en GUID; sustitúyalo aquí si su broker requiere un identificador específico (por ejemplo, para cumplir una regla de control de acceso o para reconectarse y reanudar una sesión persistente).

Cualquier otro estado de conexión (credenciales, LastWillTestament, ConnectProperties) debe configurarse en el propio componente antes de Activate, no dentro de este manejador.

Ejemplo

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;

Volver a Eventos