TsgcWSPClient_MQTT › Gebeurtenissen › OnMQTTDisconnect

OnMQTTDisconnect Event

Wordt geactiveerd wanneer de broker een DISCONNECT stuurt of de sessie is gesloten; meldt ReasonCode en MQTT 5 DisconnectProperties.

Syntaxis

property OnMQTTDisconnect: TsgcWSMQTTDisconnectEvent;
// TsgcWSMQTTDisconnectEvent = procedure(Connection: TsgcWSConnection; ReasonCode: Integer; const ReasonName: String; DisconnectProperties: TsgcWSMQTTDISCONNECTProperties) of object

Standaardwaarde

—

Opmerkingen

Signaleert dat de MQTT-sessie wordt beëindigd. MQTT 3.1.1 heeft geen door de server geïnitieerd DISCONNECT-pakket, dus in dat geval weerspiegelt de gebeurtenis een lokaal gedetecteerde sluiting. MQTT 5.0 introduceert een DISCONNECT-pakket dat de broker kan verzenden om uit te leggen waarom de verbinding wordt gesloten. Parameters:

• ReasonCode (MQTT 5) — numerieke DISCONNECT-reden (0 = Normale verbreking).
• ReasonName (MQTT 5) — voor mensen leesbare beschrijving van ReasonCode.
• DisconnectProperties (MQTT 5) — SessionExpiryInterval, ReasonString, UserProperties en ServerReference (gebruikt door de broker om de client naar een alternatieve server te leiden).

Gebruik dit evenement om de oorzaak te loggen, de UI-status bij te werken en, als ServerReference is ingesteld, te overwegen opnieuw verbinding te maken met de voorgestelde broker.

Voorbeeld

procedure TForm1.MQTTDisconnect(Connection: TsgcWSConnection;
  ReasonCode: Integer; const ReasonName: String;
  DisconnectProperties: TsgcWSMQTTDISCONNECTProperties);
begin
  Memo1.Lines.Add(Format('Disconnect %d (%s)',
    [ReasonCode, ReasonName]));

  if DisconnectProperties.ServerReference <> '' then
    Memo1.Lines.Add('Broker suggests: ' +
      DisconnectProperties.ServerReference);
end;

Terug naar Events