TsgcWSPClient_MQTT › Eventos › OnMQTTBeforeConnect

OnMQTTBeforeConnect Event

Disparado antes de o pacote CONNECT ser enviado; permite que o app substitua CleanSession e ClientIdentifier.

Sintaxe

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

Valor Padrão

—

Observações

Última oportunidade de ajustar o pacote CONNECT logo antes de ser escrito na rede. O componente gera este evento depois que o transporte WebSocket / TCP está ativo, mas antes de serializar o CONNECT, de modo que o handler pode sobrepor:

• aCleanSession (var, Boolean) — quando True (padrão), o broker descarta qualquer sessão anterior e inicia do zero; defina como False para retomar uma sessão armazenada (o MQTT 5 expõe isso de forma mais granular através de SessionExpiryInterval em ConnectProperties).
• aClientIdentifier (var, String) — o id de cliente único. O componente gera automaticamente um valor baseado em GUID; substitua-o aqui se o seu broker exigir um id específico (por exemplo, para corresponder a uma regra de controle de acesso ou para reconectar e retomar uma sessão persistente).

Qualquer outro estado de conexão (credenciais, LastWillTestament, ConnectProperties) deve ser configurado no próprio componente antes de Activate, não dentro deste handler.

Exemplo

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;

Voltar para Eventos