Utilitário do Cliente MQTT

O utilitário do cliente MQTT é um aplicativo Java™ com o qual é possível explorar os recursos do MQTT, ou seja, conectar-se a um gerenciador de filas, publicar e assinar tópicos.

Você pode usar o utilitário do cliente para verificar a configuração de telemetria (por exemplo, ao criar um canal de telemetria), ou o cliente poderá servir como auxílio quando você estiver desenvolvendo e depurando aplicativos. Para obter mais informações sobre os recursos e as propriedades do utilitário do cliente MQTT, consulte as seguintes descrições:

Publicar
Publique uma mensagem para um tópico que depois é distribuído a assinantes interessados.
Assinar
Os clientes e o listener MQXR podem registrar seu interesse em um tópico subscrevendo-se a ele e, assim, recebendo mensagens publicadas nesse tópico.
Tópico
Um tópico é a chave que identifica o canal de informações no qual as mensagens são publicadas. Os assinantes usam o nome do tópico para identificar os canais de informações nos quais eles desejam receber mensagens publicadas.
Curingas de tópico

Uma assinatura poderá conter caracteres especiais, e você pode assinar vários tópicos de uma vez. Um separador de nível de tópico usa a barra (/) para separar cada nível em um tópico, criando uma estrutura hierárquica. Por exemplo, ibm/qmgr/apple. Separadores de nível de tópico permitem mais flexibilidade e simplificam o gerenciamento dos tópicos.

Para assinaturas, dois caracteres curinga são suportados:
  • O sinal de número (#) é usado para corresponder a qualquer número de níveis em um tópico. Por exemplo, se você assinar o tópico ibm/qmgr/#, receberá mensagens nos tópicos ibm/qmgr/apple e ibm/qmgr/orange.

  • O sinal de mais (+) corresponde a apenas um nível de tópico. Por exemplo, ibm/qmgr/+ corresponde a ibm/qmgr/apple, mas não a ibm/qmgr/apple/queue.

    É possível usar o + no final da árvore de tópicos ou dentro da árvore de tópicos. Por exemplo, ibm/+ e ibm/+/orange são válidos.

Não é permitido que tópicos de publicação contenham + ou #.

Mensagem
Uma mensagem, no contexto de um utilitário do cliente MQTT, refere-se à carga útil da mensagem distribuída para os assinantes que mostram interesse em um tópico. As mensagens podem consistir em caracteres alfanuméricos.
Qualidade de serviço (QoS)
O utilitário do cliente MQTT fornece três qualidades de serviço, conforme a seguir:
No máximo uma vez (QoS = 0)
  • A mensagem é entregue no máximo uma vez, ou não é entregue de forma alguma. Não há reconhecimento no recebimento da mensagem.
  • A mensagem poderá ser perdida se o cliente for desconectado, ou o servidor falhar.
Pelo menos uma vez (QoS = 1)
  • A mensagem é entregue pelo menos uma vez. Ela poderá ser entregue diversas vezes se nenhum reconhecimento for recebido após um período de tempo ou se uma falha for detectada e a sessão de comunicação for reiniciada.
  • A mensagem deve ser armazenada localmente no emissor até que um reconhecimento seja recebido, no caso, a mensagem deve ser enviada novamente. As mensagem poderão ser duplicadas no aplicativo de recebimento.
Exatamente uma vez (QoS = 2)
  • Esse é o nível mais alto de entrega, em que uma mensagem é entregue uma vez e apenas uma vez. A entrega é assumida, mas mensagens duplicadas não são entregues ao aplicativo de recebimento.
Retido
Essa opção só é usada ao publicar mensagens. Ela determina se uma mensagem, de uma publicação em um tópico, fica retida pelo servidor MQTT (no IBM® MQ, o gerenciador de filas) depois que é entregue aos assinantes atuais. Se você criar uma assinatura de um tópico que tenha uma publicação retida, imediatamente receberá a publicação retida mais recente nesse tópico.
Último Desejo e Testamento
Essa é uma opção de conexão que determina a mensagem que é enviada ao IBM MQ, no caso de o cliente MQTT ser desconectado inesperadamente. Essa opção inclui um tópico, mensagem, QoS e a opção para reter a publicação. Considere definir o QoS como 1 ou 2 para garantir a entrega.
Limpar sessão
O início de um cliente MQTT com uma sessão de limpeza remove todas as publicações pendentes e todas as assinaturas antigas que existiam no cliente antes da conexão. Se nenhuma sessão anterior existir, o utilitário do cliente será iniciado com uma nova sessão.
Histórico do cliente
O histórico do cliente fornece informações sobre eventos que ocorrem enquanto o utilitário do cliente MQTT está sendo usado. Os exemplos de eventos incluem: Connected, Disonnected, Published ou Subscribed.

Visualize os detalhes completos de uma entrada selecionando a entrada e pressionando Enter. Como alternativa, dê um clique duplo na entrada.

Reordene as colunas no histórico do cliente, arrastando os nomes das colunas e colocando-os em qualquer ordem que você escolher.