Utilitaire client MQTT

L'utilitaire client MQTT est une application Java™ conçue pour vous permettre d'explorer les fonctions de MQTT, c'est-à-dire la connexion à un gestionnaire de files d'attente, la publication et l'abonnement à des rubriques.

Vous pouvez utiliser l'utilitaire client pour vérifier votre configuration de télémétrie (par exemple, lorsque vous créez un canal de télémétrie), ou le client peut servir comme aide lors du développement et du débogage d'applications. Pour plus d'informations sur les fonctions et les propriétés de l'utilitaire client MQTT, reportez-vous aux descriptions suivantes :

Publication
Publiez un message dans une rubrique qui est distribuée aux abonnés intéressés.
Abonnement
Les clients et le programme d'écoute MQXR peuvent enregistrer leur intérêt pour une rubrique en s'y abonnant et ainsi recevoir les messages publiés dans le cadre de cette rubrique.
Rubrique
Une rubrique est une clé identifiant un canal d'information vers lequel les messages sont publiés. Les abonnés utilisent le nom de rubrique pour identifier les canaux d'information dont ils veulent recevoir des messages publiés.
Caractères génériques de rubrique

Un abonnement peut contenir des caractères spéciaux et vous pouvez vous abonner à plusieurs rubriques à la fois. Un séparateur de niveaux de rubrique utilise la barre oblique (/) pour séparer chaque niveau dans une rubrique en créant une structure hiérarchisée. Par exemple, ibm/qmgr/apple. Les séparateurs de niveau supérieur offrent plus de souplesse et simplifient la gestion des rubriques.

Pour les abonnements, deux caractères génériques sont pris en charge :
  • Le caractère générique "#" est utilisé pour correspondre aux divers niveaux d'une rubrique. Par exemple, si vous vous abonnez à une rubrique ibm/qmgr/#, vous recevez les messages relatifs aux rubriques ibm/qmgr/apple et ibm/qmgr/orange.

  • Le signe plus (+) remplace uniquement un niveau de rubrique. Par exemple, ibm/qmgr/+ correspond à ibm/qmgr/apple mais ne correspond pas à ibm/qmgr/apple/file.

    Vous pouvez utilise le signe plus (+) à la fin de l'arborescence ou dans l'arborescence de la rubrique. Par exemple, ibm/+ et ibm/+/orange sont tous les deux admis.

Les rubriques de publication ne peuvent pas contenir (+), ni (#).

Message
Un message, dans le contexte d'un utilitaire client MQTT, correspond à la charge de message distribuée aux abonnés qui manifestent un intérêt dans la rubrique. Les messages peuvent être composés de caractères alphanumériques.
Qualité de service (QoS)
L'utilitaire client MQTT fournit trois qualités de service, qui sont les suivantes :
Au plus une fois (QoS = 0)
  • Le message est distribué une fois tout au plus, ou n'est pas distribué du tout. Il n'existe pas d'accusé de réception lors de la réception du message.
  • Le message peut être perdu si le client est déconnecté ou si le serveur échoue.
Au moins une fois (QoS = 1)
  • Le message est distribué au moins une fois. Il peut être émis plusieurs fois si aucun accusé de réception n'est reçu après une période de temps ou si une erreur est détectée et que la session de communication est redémarrée.
  • Le message doit être stocké localement au niveau de l'expéditeur jusqu'à la réception d'un accusé de réception dans le cas où le message doit être renvoyé. Les messages doivent être dupliqués au niveau de l'application de réception.
Exactement une fois (QoS = 2)
  • Il s'agit du plus haut niveau de distribution où le message est distribué une fois et une seule. La distribution est considérée comme faite, mais les message en double ne sont pas distribués à l'application de réception.
Conservé
Cette option est utilisée uniquement lors de la publication de messages. Elle détermine si un message, d'une publication dans une rubrique, est conservé par le serveur MQTT (dans IBM® MQ, le gestionnaire de files de données) après qu'il a été distribué aux abonnés en cours. Si vous créez un abonnement dans une rubrique pour laquelle une publication est conservée, vous recevez immédiatement la plus récente publication conservée sur cette publication.
Dernière volonté et testament
Cette option de connexion détermine le message envoyé IBM MQ en cas de déconnexion intempestive du client MQTT. Cette option inclut une rubrique, un message, la qualité de service (QoS) et l'option pour conserver la publication. Pensez à paramétrer QoS sur 1 ou 2 pour garantir la distribution.
Nettoyer la session
Le démarrage d'un client MQTT avec une session nettoyée supprime toutes les publications en attente et tous les anciens abonnements qui existaient sur le client avant la connexion. Si aucune session précédente n'existe, l'utilitaire client démarre avec une nouvelle session.
Historique du client
L'historique du client fournit des informations sur les événements qui se produisent lors de l'utilisation de l'utilitaire client MQTT. Exemples d'événements : Connecté, Déconnecté, Publié, ouAbonné.

Pour afficher la totalité des détails d'une entrée, sélectionnez une entrée et appuyez sur Entrée. Vous pouvez également cliquer deux fois sur l'entrée.

Pour réorganisez les colonnes dans l'historique du client, faites glisser les noms de colonne et placez-les dans l'ordre de votre choix.