Este tópico descreve os mapeamentos entre estruturas e propriedades de mensagens envolvidos na interação entre um aplicativo que usa o SDK do ApsaraMQ for RocketMQ e outro que usa o SDK do ApsaraMQ for MQTT. Essas informações facilitam o entendimento e o uso dos serviços.
O ApsaraMQ for MQTT é um serviço de gateway projetado para dispositivos móveis. Esse serviço interage com outros recursos da Alibaba Cloud, como o ApsaraMQ for RocketMQ, com base em regras de interação de dados. Para obter mais informações sobre essas regras, consulte Gerenciar regras de entrada de dados.
Se você usar apenas o ApsaraMQ for MQTT, ignore os mapeamentos descritos neste tópico e siga o protocolo Message Queuing Telemetry Transport (MQTT).
Para obter mais informações sobre o ApsaraMQ for MQTT, consulte O que é o ApsaraMQ for MQTT? e Termos.
Mapeamentos de estruturas de mensagens
O ApsaraMQ for MQTT e o ApsaraMQ for RocketMQ são sistemas de mensagens baseados no padrão publish-subscribe e compartilham conceitos semelhantes. A figura a seguir ilustra as diferenças nos principais conceitos e os mapeamentos entre esses sistemas.
Conforme mostra a figura anterior, o ApsaraMQ for MQTT oferece suporte a tópicos multinível, enquanto o ApsaraMQ for RocketMQ aceita apenas tópicos de nível único. Um tópico de primeiro nível no ApsaraMQ for MQTT corresponde a um tópico no ApsaraMQ for RocketMQ. Os tópicos dos demais níveis do ApsaraMQ for MQTT são mapeados como propriedades de mensagem no ApsaraMQ for RocketMQ.
O protocolo do ApsaraMQ for RocketMQ permite mensagens com propriedades personalizadas, mas o protocolo MQTT não oferece suporte a propriedades. Para viabilizar o rastreamento de cabeçalhos e informações de dispositivo no protocolo MQTT e permitir que usuários dos SDKs do ApsaraMQ for RocketMQ recuperem esses dados, informações específicas do ApsaraMQ for MQTT são mapeadas para propriedades de mensagem no ApsaraMQ for RocketMQ.
Para saber como configure os mapeamentos das propriedades do ApsaraMQ for RocketMQ para os parâmetros do ApsaraMQ for MQTT, consulte a tabela em Mapeamentos de propriedades.
O ApsaraMQ for RocketMQ e o ApsaraMQ for MQTT usam os resultados da serialização de dados das suas mensagens de negócio como payload. O ApsaraMQ for RocketMQ e o ApsaraMQ for MQTT não codificam nem decodificam as mensagens de negócio.
Mapeamentos de propriedades
A tabela a seguir descreve os mapeamentos de propriedades compatíveis entre o ApsaraMQ for MQTT e o ApsaraMQ for RocketMQ. Na interação entre um aplicativo com SDK do ApsaraMQ for RocketMQ e outro com SDK do ApsaraMQ for MQTT, leia e escreva propriedades para configure ou recuperar informações.
Para obter detalhes sobre QoS, cleanSession, tópico e ID do cliente, consulte Termos.
|
Parâmetro do ApsaraMQ for MQTT |
Chave da propriedade no ApsaraMQ for RocketMQ |
Valor válido da propriedade |
Descrição |
|
QoS |
qoslevel |
0, 1 e 2. |
Configure esta propriedade ao enviar mensagens do ApsaraMQ for RocketMQ para o ApsaraMQ for MQTT. Se essa propriedade não for configurada, o valor padrão será 1. O ApsaraMQ for RocketMQ lê essa propriedade diretamente das mensagens enviadas pelo ApsaraMQ for MQTT. |
|
Topic |
topic |
Uma string que indica um tópico específico. |
Não configure esta propriedade. Ela rastreia todos os tópicos de origem das mensagens enviadas do ApsaraMQ for MQTT para o ApsaraMQ for RocketMQ. |
|
cleanSession |
cleansessionflag |
true e false. |
Configure esta propriedade apenas para mensagens ponto a ponto (P2P) enviadas do ApsaraMQ for RocketMQ para o ApsaraMQ for MQTT. Se você não configurar essa propriedade, o valor padrão true será usado. Outros tipos de mensagem não aceitam esta propriedade. O ApsaraMQ for RocketMQ lê essa propriedade diretamente das mensagens enviadas pelo ApsaraMQ for MQTT. |
|
Subtopic |
mqttSecondTopic |
Uma string que indica um subtópico específico. |
Configure esta propriedade apenas ao usar subtópicos para filtrar mensagens enviadas do ApsaraMQ for RocketMQ para o ApsaraMQ for MQTT. Se você não configurar essa propriedade, ela permanecerá vazia. O ApsaraMQ for RocketMQ lê essa propriedade diretamente das mensagens enviadas pelo ApsaraMQ for MQTT. |
|
Tópico em mensagens recebidas no cliente |
mqttRealTopic |
A substring de nível inferior que o aplicativo espera exibir nos clientes receptores. |
Configure esta propriedade apenas quando um cliente ApsaraMQ for MQTT precisar exibir o nome do subtópico especificado após receber mensagens do ApsaraMQ for RocketMQ. Geralmente, aplica-se a mensagens P2P. Se você não configurar essa propriedade, as mensagens P2P usarão um nome de tópico fixo. Esta propriedade não está disponível para mensagens enviadas do ApsaraMQ for MQTT para o ApsaraMQ for RocketMQ. |
|
clientId |
clientId |
Uma string que indica um ID de cliente específico. |
Não configure esta propriedade. Ela rastreia o ID do cliente ApsaraMQ for MQTT que envia mensagens para o ApsaraMQ for RocketMQ. |