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.