Obslužný program klienta protokolu MQTT

Obslužný program klienta protokolu MQTT je aplikací jazyka Java™, kterou lze použít k prozkoumání funkcí protokolu MQTT, tedy k připojení ke správci front a k publikování a odebírání témat.

Obslužný program klienta lze použít k ověření nastavení telemetrie (například při vytvoření kanálu telemetrie), nebo může tento klient pomáhat při vývoji a ladění aplikací. Další informace o funkcích a vlastnostech obslužného programu klienta protokolu MQTT naleznete v následujících popisech:

Publikovat
Publikování zprávy do tématu, které je následně distribuováno příslušným odběratelům.
Odebírat
Klienti a modul listener MQXR mohou vyjádřit zájem o téma pomocí přihlášení k odběru, a přijímat tak zprávy publikované do daného tématu.
Téma
Téma je klíčem, který identifikuje informace o kanálu, kam jsou zprávy publikovány. Odběratelé používají název tématu k identifikaci informačních kanálů, z nichž chtějí přijímat publikované zprávy.
Zástupné znaky tématu

Odběr může obsahovat speciální znaky a dále je možné odebírat více témat najednou. Oddělovač úrovní tématu používá k oddělení jednotlivých úrovní v tématu znak lomítka (/), čímž vytváří hierarchickou strukturu. Příklad: ibm/qmgr/apple. Oddělovače úrovní tématu poskytují vyšší míru flexibility a zjednodušují správu témat.

Pro odběry jsou podporovány dva zástupné znaky:
  • Znak křížku (#) zastupuje libovolný počet úrovní v rámci tématu. Například pokud se přihlásíte k odběru tématu ibm/qmgr/#, obdržíte zprávy z témat ibm/qmgr/apple a ibm/qmgr/orange.

  • Znak plus (+) zastupuje pouze jednu úroveň v rámci tématu. Například řetězci ibm/qmgr/+ odpovídá téma ibm/qmgr/apple, ale ne téma ibm/qmgr/apple/queue.

    Znak + lze použít na konci nebo uvnitř stromu témat. Řetězce ibm/+ a ibm/+/orange jsou tedy oba platné.

Témata publikování nesmí obsahovat žádný ze znaků + a #.

Zpráva
Zpráva v kontextu obslužného programu klienta protokolu MQTT odkazuje na informační obsah zprávy distribuovaný odběratelům, kteří vyjádřili zájem o téma. Zprávy se mohou skládat z alfanumerických znaků.
Kvalita služby (QoS)
Obslužný program klienta protokolu MQTT poskytuje tři úrovně kvality služby:
Nejvíce jednou (QoS = 0)
  • Zpráva je doručena nejvíce jednou nebo není doručena vůbec. Při přijetí zprávy není vydáváno žádné potvrzení.
  • Při odpojení klienta nebo selhání serveru může dojít ke ztrátě zprávy.
Nejméně jednou (QoS = 1)
  • Zpráva je doručena nejméně jednou. Pokud během zadaného období nedojde k přijetí potvrzení nebo pokud je zjištěno selhání a komunikační relace je restartována, zpráva může být doručena vícekrát.
  • Zpráva musí být uložena lokálně v odesilateli, dokud nedojde k příjmu potvrzení, pro případ, že by bylo nutné ji odeslat znovu. Zprávy mohou být v přijímající aplikaci duplikovány.
Právě jednou (QoS = 2)
  • Jedná se o nejvyšší úroveň doručení, kdy je zpráva doručena právě jednou. Doručení je předpokládáno, ale do přijímající aplikace nejsou doručovány duplicitní zprávy.
Zachováno
Tato volba je používána pouze pro publikování zpráv. Určuje, zda je zpráva z publikování v tématu uchovávána serverem MQTT (ve správci front produktu IBM® MQ) po jejím doručení aktuálním odběratelům. Pokud vytvoříte odběr tématu, kde je nestaveno zachované publikování, okamžitě obdržíte nejaktuálnější zachované publikování v tomto tématu.
Poslední zpráva při selhání
Jedná se o volbu připojení, která určuje zprávu odeslanou do produktu IBM MQ v případě neočekávaného odpojení klienta protokolu MQTT. Tato volba zahrnuje téma, zprávu, kvalitu služeb a volbu zachování publikování. Zvažte nastavení volby Kvalita služby (QoS) na hodnotu 1 nebo 2, která zaručuje doručení.
Vymazat relaci
Spuštění klienta protokolu MQTT s volbou vymazání relace odebere všechna nevyřízená publikování a všechna původní publikování, která v klientovi existovala před daným připojením. Pokud neexistuje žádná předchozí relace, obslužný program klienta bude spuštěn s novou relací.
Historie klienta
Historie klienta poskytuje informace o událostech, k nimž došlo během používání obslužného programu klienta protokolu MQTT. Příklady událostí: Připojeno, Odpojeno, Publikováno nebo S přihlášeným odběrem.

Úplné podrobnosti o jednotlivých položkách zobrazíte jejich výběrem a stisknutím klávesy Enter. Případně můžete na položky poklepat.

Sloupce v historii klienta můžete přeuspořádat pomocí přetažení názvů sloupců a jejich umístění v požadovaném pořadí.