MQTT Connector: Konfiguration

Um die benötigten Informationen für den Subscriber bereitzustellen, ist eine Konfigurationsdatei mit der Endung *.mqtt erforderlich, die beim Serverstart geladen wird.

Die Konfigurationsdatei liegt auf Hauptebene des Projektes und wird bei Serverstart geladen.

Die Werte für clientId, cleanSession und timeout können auch über Adapterparameter gesetzt werden.

Wenn nicht alle Parameter über die Adapterkonfiguration gesetzt werden, werden die Dateien aus der Konfigurationsdatei *.mqtt verwendet.

So erstellen Sie die Konfigurationsdatei

Klicken Sie mit der rechten Maustaste auf den Namen des Projekts in der Sicht Projects.
Ein Dialogfenster öffnet sich.
Wählen Sie New > .mqtt. Die Konfigurationsdatei mit der Endung .mqtt wurde nun auf Hauptebene des Projekts erstellt.

Die Datei hat folgende Struktur:

CODE

<?xml version="1.0" encoding="UTF-8"?>
<MqttConfiguration>
	<threadPoolSize>10</threadPoolSize> 
	<broker server = "tcp://localhost:1883"> 
		<client id="1" active="true" cleanSession="false" timeout="30" automaticReconnect="true">
			<topic filter="topic1" qos="AT_LEAST_ONCE"></topic>
			<process url="Processes/data.wrf"></process>
		</client>
	</broker>
</MqttConfiguration>

Folgende Elemente sind in der Konfigurationsdatei enthalten:

Element / Attribut	Beschreibung
`MqttConfiguration`	Wurzelelement der Konfigurationsdatei
`threadPoolSize`	Anzahl verwendbarer Threads Mögliche Werte: Ganzzahl (Integer)
`broker server`	Host und Port des Brokers Mögliche Werte: Host und Port des Brokers getrennt durch Semikolon
`client id`	Eindeutige Client-ID mit folgenden Attributen: `active`: Der Subscriber-Prozess wird nur für einen aktiven Client gestartet. Mögliche Werte: `true`: Der Client ist aktiv. `false`: Der Client ist nicht aktiv. `cleanSession`: Legt fest, ob nach einer Session Daten gelöscht werden oder nicht. Mögliche Werte: `true`: Daten werden nach einer Session gelöscht. `false`: Daten werden nach einer Session nicht gelöscht. `timeout`: Wert in Sekunden, wie lange die Client-Verbindung erhalten bleiben soll bzw. nach welcher Zeit die Verbindung getrennt werden soll. Mögliche Werte: Ganzzahl `automaticReconnect`: Gibt an, ob der Client im Falle eines Verbindungsabbruchs wieder verbunden werden soll. Mögliche Werte: `true`: Der Client soll im Falle eines Verbindungsabbruchs wieder verbunden werden. `false`: Der Client soll im Falle eines Verbindungsabbruchs nicht wieder verbunden werden.
`topic`	Topic, das abonniert werden kann, um die veröffentlichte Nachricht zu erhalten. Es hat folgende Attribute: `filter`: Name des Topic-Filters `qos`: Quality of service
`qos`	Für Topics kann ein Quality-Of-Service (QOS) gesetzt werden. Es gibt drei mögliche QOS. Dies kann in der Konfigurationsdatei wie folgt gesetzt werden: `AT_LEAST_ONCE`: Die Nachricht wird mindestens einmal zugestellt. Das ist die sicherste Option. `AT_MOST_ONCE`: Es gibt keine Garantie, dass die Nachricht zugestellt wird. Die schnellste Option. `EXACTLY_ONCE`: Die Nachricht wird genau einmal zugestellt oder nicht zugestellt. Garantiert, dass keine Duplikate zugestellt werden.
`process url`	Gibt an, in welchem Prozess die empfangenen Daten verwendet werden sollen. Die empfangenen Daten werden als XML in den Prozess geschrieben. Mögliche Werte: Pfad zum Prozess Beispiel: `"Processes/data.wrf"`