Programma di utilità del client MQTT

Il programma di utilità del client MQTT è un'applicazione Java che consente di esplorare le funzioni di MQTT; in altre parole, consente il collegamento a un gestore code e la pubblicazione e la sottoscrizione agli argomenti.

È possibile utilizzare il programma di utilità del client per verificare la configurazione della telemetria (ad esempio, quando si crea un canale di telemetria) oppure il client potrebbe essere di ausilio durante lo sviluppo e l'esecuzione del debug delle applicazioni. Per ulteriori informazioni sulle funzioni e sulle proprietà del programma di utilità del client MQTT, consultare le seguenti descrizioni:

Pubblica
Pubblicare un messaggio a un argomento che viene distribuito ai sottoscrittori interessati.
Sottoscrivi
I client e i listener MQXR possono registrare il proprio interesse in un argomento sottoscrivendolo; in questo modo riceveranno i messaggi pubblicati in quell'argomento.
Argomento
Un argomento è la chiave che consente di identificare il canale di informazioni nel quale vengono pubblicati i messaggi. I sottoscrittori utilizzano il nome dell'argomento per identificare i canali di informazioni nei quali desiderano ricevere i messaggi pubblicati.
Caratteri jolly per gli argomenti

Una sottoscrizione potrebbe contenere caratteri speciali ed è possibile sottoscrivere più argomenti contemporaneamente. Un separatore dei livelli di argomenti utilizza la barra (/) per separare ciascun livello in un argomento, creando una struttura gerarchica. Ad esempio, ibm/qmgr/apple. I separatori dei livelli di argomenti consentono una maggiore flessibilità e semplificano la gestione degli argomenti.

Per le sottoscrizioni, sono supportati due caratteri jolly:
  • Il simbolo cancelletto (#) viene utilizzato per rilevare la corrispondenza tra i numeri dei livelli in un argomento. Ad esempio, se si sottoscrive l'argomento ibm/qmgr/#, si ricevono i messaggi sugli argomenti ibm/qmgr/apple e ibm/qmgr/orange.

  • Il segno più (+) corrisponde soltanto a un livello di argomento. Ad esempio, ibm/qmgr/+ corrisponde a ibm/qmgr/apple ma non a ibm/qmgr/apple/queue.

    È possibile utilizzare il + alla fine o all'interno della struttura ad albero dell'argomento. Ad esempio, ibm/+ e ibm/+/orange sono entrambi validi.

Gli argomenti di pubblicazione non possono contenere il segno + o #.

Messaggio
Un messaggio, nel contesto di un programma di utilità del client MQTT, fa riferimento al payload messaggi distribuito ai sottoscrittori che mostrano interesse in un argomento. I messaggi possono contenere caratteri alfanumerici.
QoS (Quality of service)
Il programma di utilità del client MQTT fornisce tre qualità di servizio, come indicato di seguito:
Al massimo una volta (QoS = 0)
  • Il messaggio viene consegnato al massimo una volta oppure non viene consegnato. Non è prevista la conferma di ricezione del messaggio.
  • Se il client è disconnesso o se si verifica un errore nel server, il messaggio potrebbe andare perso.
Almeno una volta (QoS = 1)
  • Il messaggio viene consegnato almeno una volta. Potrebbe essere consegnato più volte se non viene ricevuta una conferma dopo un periodo di tempo o se viene rilevato un errore e la sessione di comunicazione viene riavviata.
  • Il messaggio deve essere memorizzato localmente al mittente fino alla ricezione della conferma, nel caso in cui è necessario inviare di nuovo il messaggio. Il messaggio potrebbe essere duplicato nell'applicazione ricevente.
Esattamente una volta (QoS = 2)
  • Questo è il livello più alto di consegna dove viene consegnato un messaggio una e una sola volta. La consegna viene utilizzata, ma i messaggi duplicati non vengono consegnati all'applicazione ricevente.
Conservato
Questa opzione viene utilizzata soltanto durante la pubblicazione dei messaggi. Determina se un messaggio, da una pubblicazione su un argomento, viene conservato dal server MQTT (in IBM® MQ, il gestore code) dopo che viene consegnato agli attuali sottoscrittori. Se si crea una sottoscrizione a un argomento che ha una pubblicazione correlata, si riceve immediatamente la pubblicazione conservata su quell'argomento.
Ultime indicazioni
Questa è un'opzione di connessione che determina il messaggio inviato a IBM MQ, in caso di disconnessione inaspettata del client MQTT. Questa opzione comprende un argomento, un messaggio, QoS e l'opzione per conservare la pubblicazione. Considerare l'impostazione di QoS su 1 o 2 per garantire la consegna.
Pulisci sessione
L'avvio di un client MQTT con Pulisci sessione consente di rimuovere tutte le pubblicazioni in sospeso e tutte le vecchie sottoscrizioni esistite nel client prima della connessione. Se non esiste alcuna sessione precedente, il programma di utilità del client si avvia con una nuova sessione.
Cronologia client
La cronologia client fornisce informazioni sugli eventi che si verificano durante l'utilizzo del programma di utilità del client MQTT. Esempi di eventi includono: Connected, Disonnected, Publishedo Subscribed.

Visualizzare i dettagli completi di una voce selezionando la voce e premendo Invio. In alternativa, fare doppio clic sulla voce.

Riordinare le colonne nella cronologia client trascinando i nomi delle colonne e posizionandoli nell'ordine desiderato.