Topik ini menjelaskan pemetaan struktur pesan dan properti yang digunakan ketika aplikasi dengan SDK ApsaraMQ for RocketMQ berinteraksi dengan aplikasi menggunakan SDK ApsaraMQ for MQTT. Informasi ini membantu Anda memahami dan menggunakan layanan tersebut.
ApsaraMQ for MQTT adalah layanan gateway yang dirancang untuk perangkat mobile. ApsaraMQ for MQTT dapat berinteraksi dengan layanan Alibaba Cloud lainnya seperti ApsaraMQ for RocketMQ berdasarkan aturan interaksi data. Untuk informasi lebih lanjut tentang aturan tersebut, lihat Kelola Aturan Arah Masuk Data.
Jika Anda hanya menggunakan ApsaraMQ for MQTT, abaikan pemetaan yang dijelaskan dalam topik ini dan ikuti protokol Message Queuing Telemetry Transport (MQTT).
Untuk informasi lebih lanjut tentang ApsaraMQ for MQTT, lihat Apa itu ApsaraMQ for MQTT? dan Istilah.
Pemetaan struktur pesan
ApsaraMQ for MQTT dan ApsaraMQ for RocketMQ adalah sistem pesan berbasis pola publikasi-langganan dengan konsep serupa. Gambar berikut menunjukkan perbedaan utama dan pemetaan antara kedua sistem pesan tersebut.
Seperti ditunjukkan pada gambar sebelumnya, ApsaraMQ for MQTT mendukung topik multi-level, sedangkan ApsaraMQ for RocketMQ hanya mendukung topik satu level. Topik level-1 di ApsaraMQ for MQTT dipetakan ke topik di ApsaraMQ for RocketMQ, sementara topik level lainnya di ApsaraMQ for MQTT dipetakan ke properti pesan di ApsaraMQ for RocketMQ.
Protokol ApsaraMQ for RocketMQ mendukung pesan dengan properti kustom, sedangkan protokol MQTT tidak mendukung properti. Untuk memudahkan pelacakan header dan informasi perangkat dalam protokol MQTT serta memungkinkan pengguna SDK ApsaraMQ for RocketMQ mengambil informasi tersebut, informasi tertentu di ApsaraMQ for MQTT dipetakan ke properti pesan di ApsaraMQ for RocketMQ.
Untuk informasi tentang cara mengonfigurasi pemetaan dari properti di ApsaraMQ for RocketMQ ke parameter di ApsaraMQ for MQTT, lihat tabel di Pemetaan Properti.
ApsaraMQ for RocketMQ dan ApsaraMQ for MQTT menggunakan hasil serialisasi data dari pesan bisnis Anda sebagai payload. ApsaraMQ for RocketMQ dan ApsaraMQ for MQTT tidak mengkodekan atau mendekode pesan bisnis.
Pemetaan properti
Tabel berikut menjelaskan pemetaan properti yang didukung antara ApsaraMQ for MQTT dan ApsaraMQ for RocketMQ. Ketika aplikasi yang menggunakan SDK ApsaraMQ for RocketMQ berinteraksi dengan aplikasi yang menggunakan SDK ApsaraMQ for MQTT, Anda dapat membaca dan menulis properti untuk mengonfigurasi atau mengambil informasi.
Untuk informasi tentang QoS, cleanSession, topik, dan ID klien, lihat Istilah.
Parameter ApsaraMQ for MQTT | Kunci properti ApsaraMQ for RocketMQ | Nilai properti valid | Deskripsi |
QoS | qoslevel | 0, 1, dan 2. | Anda dapat mengonfigurasi properti ini saat pesan dikirim dari ApsaraMQ for RocketMQ ke ApsaraMQ for MQTT. Jika properti ini tidak dikonfigurasi, nilai default 1 digunakan. ApsaraMQ for RocketMQ dapat langsung membaca properti ini dari pesan yang dikirim dari ApsaraMQ for MQTT. |
Topik | topic | String yang menunjukkan topik tertentu. | Anda tidak dapat mengonfigurasi properti ini. Properti ini digunakan untuk melacak semua topik dari mana pesan dikirim dari ApsaraMQ for MQTT ke ApsaraMQ for RocketMQ. |
cleanSession | cleansessionflag | true dan false. | Anda dapat mengonfigurasi properti ini hanya saat pesan Point-to-Point (P2P) dikirim dari ApsaraMQ for RocketMQ ke ApsaraMQ for MQTT. Jika Anda tidak mengonfigurasi properti ini, nilai default true digunakan. Anda tidak dapat mengonfigurasi properti ini untuk jenis pesan lainnya. ApsaraMQ for RocketMQ dapat langsung membaca properti ini dari pesan yang dikirim dari ApsaraMQ for MQTT. |
Subtopik | mqttSecondTopic | String yang menunjukkan subtopik tertentu. | Anda dapat mengonfigurasi properti ini hanya saat subtopik digunakan untuk menyaring pesan yang dikirim dari ApsaraMQ for RocketMQ ke ApsaraMQ for MQTT. Jika Anda tidak mengonfigurasi properti ini, properti ini dibiarkan kosong. ApsaraMQ for RocketMQ dapat langsung membaca properti ini dari pesan yang dikirim dari ApsaraMQ for MQTT. |
Topik dalam pesan yang diterima pada klien | mqttRealTopic | String sub-level yang diharapkan oleh bisnis untuk ditampilkan oleh klien penerima pesan. | Anda dapat mengonfigurasi properti ini hanya saat klien ApsaraMQ for MQTT diharapkan menampilkan nama subtopik tertentu setelah klien menerima pesan dari ApsaraMQ for RocketMQ. Dalam banyak kasus, properti ini diterapkan pada pesan P2P. Jika Anda tidak mengonfigurasi properti ini, pesan P2P menggunakan nama topik tetap. Properti ini tidak tersedia saat pesan dikirim dari ApsaraMQ for MQTT ke ApsaraMQ for RocketMQ. |
clientId | clientId | String yang menunjukkan ID klien tertentu. | Anda tidak dapat mengonfigurasi properti ini. Properti ini digunakan untuk melacak ID klien ApsaraMQ for MQTT dari mana pesan dikirim ke ApsaraMQ for RocketMQ. |