Program narzędziowy klienta MQTT

Program narzędziowy klienta MQTT jest aplikacją Java™, za pomocą której można zapoznać się z funkcjami klienta MQTT, takimi jak nawiązywanie połączenia z menedżerem kolejek, a także publikowanie w tematach i subskrybowanie tematów.

Za pomocą programu narzędziowego klienta można weryfikować ustawienia telemetrii (na przykład podczas tworzenia kanału pomiarowego). Klient jest także pomocny podczas tworzenia i debugowania aplikacji. Więcej informacji dotyczących funkcji i właściwości programu narzędziowego klienta MQTT można znaleźć w poniższych opisach:

Publikowanie
Po opublikowaniu komunikatu w temacie jest on dystrybuowany do zainteresowanych subskrybentów.
Subskrybowanie
Klienty i obiekty nasłuchiwania MQXR mogą zgłosić zainteresowanie tematem, subskrybując go, dzięki czemu będą otrzymywać komunikaty opublikowane w tym temacie.
Temat
Temat jest kluczem umożliwiającym identyfikację kanału informacyjnego, w którym są publikowane komunikaty. Subskrybenci używają nazwy tematu w celu zidentyfikowania kanałów informacyjnych, z których chcą otrzymywać opublikowane komunikaty.
Znaki wieloznaczne tematu

Istnieje możliwość subskrybowania wielu tematów jednocześnie, a subskrypcja może zawierać znaki specjalne. Separator poziomu tematu to prawy ukośnik (/), który oddziela poziomy w temacie, tworząc strukturę hierarchiczną. Na przykład ibm/qmgr/apple. Separatory poziomu tematu pozwalają osiągnąć większą elastyczność oraz ułatwiają zarządzanie tematami.

W przypadku subskrypcji obsługiwane są dwa znaki wieloznaczne:
  • Znaku krzyżyka (#) można użyć w celu dopasowania dowolnej liczby poziomów w ramach tematu. Na przykład w przypadku subskrypcji tematu ibm/qmgr/# subskrybent będzie otrzymywał komunikaty dotyczące tematów ibm/qmgr/apple oraz ibm/qmgr/orange.

  • Znak plus (+) umożliwia dopasowanie tylko jednego poziomu tematu. Na przykład subskrypcja ibm/qmgr/+ jest zgodna z tematem ibm/qmgr/apple, ale nie jest zgodna z tematem ibm/qmgr/apple/queue.

    Znaku + można użyć na końcu drzewa tematów lub wewnątrz drzewa tematów. Na przykład zarówno zapis ibm/+, jak i zapis ibm/+/orange jest poprawny.

Tematy publikowania nie mogą zawierać znaków + i #.

Komunikat
Komunikat w kontekście programu narzędziowego klienta MQTT oznacza ładunek komunikatu dystrybuowany do subskrybentów zainteresowanych danym tematem. Komunikaty zawierają znaki alfanumeryczne.
Jakość usługi (Quality of service, QoS)
Program narzędziowy klienta MQTT udostępnia następujące trzy rodzaje jakości usługi:
Nie więcej niż raz (QoS = 0)
  • Komunikat jest dostarczany nie więcej niż jeden raz lub nie jest dostarczany w ogóle. Przy odbieraniu komunikatu nie jest wymagane potwierdzenie.
  • Komunikat może zostać utracony, jeśli klient zostanie rozłączony lub nastąpi awaria serwera.
Co najmniej raz (QoS = 1)
  • Komunikat jest dostarczany co najmniej jeden raz. Komunikat może zostać dostarczony wiele razy, jeśli nadawca nie otrzyma potwierdzenia po upłynięciu określonego okresu lub wykryto awarię i zrestartowano sesję komunikacji.
  • Komunikat musi być przechowywany lokalnie przez nadawcę do momentu otrzymania potwierdzenia na wypadek konieczności ponownego wysłania komunikatu. Komunikaty mogą zostać zduplikowane w aplikacji odbierającej.
Dokładnie raz (QoS = 2)
  • Jest to najwyższy poziom trybu dostarczania, w którym komunikat jest dostarczany dokładnie jeden raz. Komunikat zostaje dostarczony, ale zduplikowane komunikaty nie są dostarczane do aplikacji odbierającej.
Zachowany
Ta opcja jest używana tylko podczas publikowania komunikatów. Służy ona do określania, czy komunikat po opublikowaniu w temacie i dostarczeniu do bieżących subskrybentów jest zachowywany przez serwer MQTT (menedżer kolejek w produkcie IBM® MQ). W przypadku zasubskrybowania tematu z zachowaną publikacją subskrybent natychmiast otrzyma najnowszą zachowaną publikację dotyczącą tego tematu.
Ostatnia wola i testament
To jest opcja połączenia umożliwiająca określenie komunikatu, który zostanie wysłany do produktu IBM MQ w przypadku nieoczekiwanego rozłączenia klienta MQTT. Ta opcja zawiera temat, komunikat, poziom jakości usługi oraz opcję zachowania publikacji. Aby zagwarantować dostarczanie, należy rozważyć ustawienie wartości 1 lub 2 dla jakości usługi (QoS).
Wyczyść sesję
Uruchomienie klienta MQTT z opcją Wyczyść sesję powoduje usunięcie wszystkich oczekujących publikacji i starych subskrypcji istniejących na tym kliencie przed nawiązaniem połączenia. Jeśli nie istnieje żadna poprzednia sesja, program narzędziowy klienta zostanie uruchomiony z nową sesją.
Historia klienta
Historia klienta zawiera informacje dotyczące zdarzeń, które wystąpiły podczas korzystania z programu narzędziowego klienta MQTT. Przykłady zdarzeń: Połączono, Rozłączono, Opublikowano lub Zasubskrybowano.

Aby wyświetlić wszystkie szczegóły pozycji, należy wybrać daną pozycję i nacisnąć klawisz Enter. Można także kliknąć dwukrotnie daną pozycję.

Aby zmienić kolejność kolumn w historii klienta, należy przeciągnąć nazwy kolumn i umieścić je w odpowiedniej kolejności.