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.