Proyek demo - ApsaraMQ for MQTT

Bagian ini menjelaskan proyek demo untuk ApsaraMQ for MQTT dan memberikan panduan penggunaan dalam berbagai skenario. Untuk detail lebih lanjut, lihat komentar pada kode sumber demo.

Mendapatkan demo untuk beberapa bahasa pemrograman

Untuk set lengkap contoh kode, lihat mqtt-demo.

Setelah mengekstrak paket yang diunduh, folder bernama mqtt-demo-main akan muncul di mesin lokal Anda. Folder tingkat pertama dikategorikan berdasarkan bahasa pemrograman. Lakukan debugging sesuai dengan kebutuhan bisnis Anda.

Java

Skenario	Tautan unduhan
Contoh cara menggunakan hanya ApsaraMQ for MQTT untuk mengirim dan berlangganan pesan	mqtt.demo.java
Contoh cara menggunakan mode autentikasi tanda tangan ApsaraMQ for MQTT	mqtt.signature.mode.demo.java
Contoh cara menggunakan mode autentikasi token ApsaraMQ for MQTT	mqtt.token.mode.demo.java
Contoh cara menggunakan fitur enkripsi SSL ApsaraMQ for MQTT	mqtt.ssl.demo.java
Contoh cara menggunakan ApsaraMQ for MQTT untuk mengirim pesan dan ApsaraMQ for RocketMQ untuk berlangganan pesan	mqtt.to.rocketmq.demo.java
Contoh cara menggunakan ApsaraMQ for RocketMQ untuk mengirim pesan dan ApsaraMQ for MQTT untuk berlangganan pesan	rocketmq.to.mqtt.demo.java
Contoh cara menggunakan ApsaraMQ for MQTT untuk mengirim pesan terurut dan ApsaraMQ for RocketMQ untuk berlangganan pesan terurut	mqtt.ordered.msg.demo.java
Contoh cara mengonfigurasi notifikasi status asinkron untuk klien ApsaraMQ for MQTT	mqtt.client.status.notice.demo.java
Contoh cara menggunakan mode autentikasi SSL mutual ApsaraMQ for MQTT	mqtt.bissl.demo.java

Python

Skenario	Tautan unduhan
Contoh cara menggunakan hanya ApsaraMQ for MQTT untuk mengirim dan berlangganan pesan	mqtt.demo.python
Contoh cara menggunakan mode autentikasi tanda tangan ApsaraMQ for MQTT	mqtt.signature.mode.demo.python
Contoh cara menggunakan fitur enkripsi SSL ApsaraMQ for MQTT	mqtt.ssl.mode.demo.python

PHP

Skenario	Tautan unduhan
Contoh cara menggunakan hanya ApsaraMQ for MQTT untuk mengirim dan berlangganan pesan	mqtt.demo.php
Contoh cara menggunakan mode autentikasi tanda tangan ApsaraMQ for MQTT	mqtt.signature.mode.demo.php
Contoh cara menggunakan mode autentikasi token ApsaraMQ for MQTT	mqtt.token.mode.demo.php
Contoh cara menggunakan ApsaraMQ for MQTT untuk mengirim pesan terurut dan ApsaraMQ for RocketMQ untuk berlangganan pesan terurut	mqtt.ordered.msg.demo.php

C

Skenario	Tautan unduhan
Contoh cara menggunakan hanya ApsaraMQ for MQTT untuk mengirim dan berlangganan pesan	mqtt.demo.c
Contoh cara menggunakan mode autentikasi tanda tangan ApsaraMQ for MQTT	mqtt.signature.mode.demo.c
Contoh cara menggunakan fitur enkripsi SSL ApsaraMQ for MQTT	mqtt.ssl.demo.c

Catatan

Untuk informasi tentang pustaka dependensi untuk C, lihat eclipse/paho.mqtt.c.

.NET

Skenario	Tautan unduhan
Contoh cara menggunakan hanya ApsaraMQ for MQTT untuk mengirim dan berlangganan pesan	mqtt.demo.net
Contoh cara menggunakan mode autentikasi tanda tangan ApsaraMQ for MQTT	mqtt.signature.mode.demo.net
Contoh cara menggunakan fitur enkripsi SSL ApsaraMQ for MQTT	mqtt.ssl.mode.demo.net

JavaScript

Skenario	Tautan unduhan
Contoh cara menggunakan hanya ApsaraMQ for MQTT untuk mengirim dan berlangganan pesan	mqtt.demo.javascript
Contoh cara menggunakan mode autentikasi tanda tangan ApsaraMQ for MQTT	mqtt.signature.mode.demo.javascript
Contoh cara menggunakan fitur enkripsi SSL ApsaraMQ for MQTT	mqtt.ssl.demo.javascript
Contoh cara menggunakan WebSocket untuk mengirim dan berlangganan pesan di ApsaraMQ for MQTT	mqtt.websocket.demo.javascript

iOS

Skenario	Tautan unduhan
Contoh cara menggunakan hanya ApsaraMQ for MQTT untuk mengirim dan berlangganan pesan	mqtt.demo.ios
Contoh cara menggunakan mode autentikasi tanda tangan ApsaraMQ for MQTT	mqtt.signature.mode.demo.ios
Contoh cara menggunakan fitur enkripsi SSL ApsaraMQ for MQTT	mqtt.ssl.demo.ios

Catatan penggunaan

Jika Anda menggunakan ApsaraMQ for MQTT bersama layanan penyimpanan pesan backend lainnya seperti ApsaraMQ for RocketMQ, pastikan Anda memahami pemetaan antara struktur pesan dan atribut. Untuk informasi lebih lanjut, lihat Pemetaan Struktur Pesan antara ApsaraMQ for MQTT dan ApsaraMQ for RocketMQ.

Catatan

Kelengkapan demo bervariasi tergantung pada bahasa pemrograman. Pembaruan untuk demo akan disediakan di versi mendatang. Jika fitur tidak tersedia di demo, unduh SDK untuk bahasa pemrograman yang sesuai dan lakukan debugging pada fitur tersebut. Untuk informasi lebih lanjut, lihat contoh Java.

Konfigurasikan kredensial akses

Sebelum menggunakan kode contoh, Anda harus mengonfigurasi variabel lingkungan MQTT_AK_ENV dan MQTT_SK_ENV. Bagian berikut menjelaskan cara mengonfigurasi variabel lingkungan.

Penting

Pasangan AccessKey dari akun Alibaba Cloud dapat digunakan untuk mengakses semua operasi API. Jika pasangan AccessKey dari akun Alibaba Cloud bocor, semua sumber daya yang dimiliki oleh akun tersebut terpapar pada risiko potensial. Untuk memastikan keamanan akun, kami sarankan Anda menggunakan pasangan AccessKey dari pengguna RAM untuk mengakses operasi API dan melakukan pemeliharaan rutin. Untuk informasi tentang cara memperoleh pasangan AccessKey, lihat Buat Pasangan AccessKey.

Sistem operasi Linux dan macOS

Buat file .bash_profile.
Catatan
Jika Anda mengonfigurasi variabel lingkungan untuk pertama kali, jalankan perintah touch ~/.bash_profile untuk membuat file konfigurasi. Jika file konfigurasi sudah ada, jalankan perintah vim ~/.bash_profile untuk mengedit file konfigurasi.
```
touch ~/.bash_profile
vim ~/.bash_profile
```

Konfigurasikan file .bash_profile.

# Ganti <ACCESS_KEY_ID> dan <ACCESS_KEY_SECRET> dalam perintah berikut dengan ID AccessKey dan rahasia AccessKey Anda.
export MQTT_AK_ENV=<ACCESS_KEY_ID>
export MQTT_SK_ENV=<ACCESS_KEY_SECRET>

Simpan file setelah selesai mengonfigurasi.

Gunakan file .bash_profile.

# Jalankan perintah berikut di file konfigurasi.
source ~/.bash_profile
# Periksa apakah konfigurasi berhasil diterapkan.
echo $MQTT_AK_ENV

Jika pasangan AccessKey yang dikembalikan valid, konfigurasi berhasil.

Penting

Setelah mengonfigurasi variabel lingkungan, mulai ulang alat atau layanan pengembangan Anda, seperti integrated development environment (IDE). Jika tidak, pengaturan baru mungkin tidak berlaku seperti yang diharapkan.

Sistem operasi Windows

Gunakan GUI

Prosedur
Untuk mengonfigurasi variabel lingkungan di Windows 10 menggunakan GUI, ikuti langkah-langkah berikut:
Di desktop Windows, klik kanan This PC dan pilih Properties. Di halaman yang muncul, klik Advanced system settings. Dalam kotak dialog System Properties, klik Environment Variables pada tab Advanced. Dalam kotak dialog Environment Variables, klik New di bagian User variables atau System variables. Kemudian, konfigurasikan variabel yang dijelaskan dalam tabel berikut.
Variabel
Contoh
ID AccessKey
Nama variabel: MQTT_AK_ENV
Nilai variabel: LTAI****
Rahasia AccessKey
Nama variabel: MQTT_SK_ENV
Nilai variabel: EZJn****
Periksa apakah konfigurasi berhasil.
Klik Start atau tekan Win+R. Dalam kotak dialog Run, masukkan cmd dan klik OK atau tekan tombol Enter untuk membuka Command Prompt. Kemudian, jalankan perintah echo %MQTT_AK_ENV% dan echo %MQTT_SK_ENV%. Jika pasangan AccessKey yang valid dikembalikan, konfigurasi berhasil.

Gunakan CMD

Prosedur
Buka jendela Command Prompt sebagai administrator dan jalankan perintah berikut untuk menambahkan variabel lingkungan di sistem operasi:
```
setx MQTT_AK_ENV LTAI**** /M
setx MQTT_SK_ENV EZJn**** /M
```
/M menunjukkan bahwa variabel lingkungan bersifat tingkat sistem. Anda tidak dapat menggunakan parameter ini saat mengonfigurasi variabel lingkungan tingkat pengguna.
Periksa apakah konfigurasi berhasil.
Klik Start atau tekan Win+R. Dalam kotak dialog Run, masukkan cmd dan klik OK atau tekan tombol Enter untuk membuka Command Prompt. Kemudian, jalankan perintah echo %MQTT_AK_ENV% dan echo %MQTT_SK_ENV%. Jika pasangan AccessKey yang valid dikembalikan, konfigurasi berhasil.

Gunakan Windows PowerShell

Dalam PowerShell, konfigurasikan variabel lingkungan baru. Variabel lingkungan berlaku untuk semua sesi baru.

[System.Environment]::SetEnvironmentVariable('MQTT_AK_ENV', 'LTAI****', [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable('MQTT_SK_ENV', 'EZJn****', [System.EnvironmentVariableTarget]::User)

Konfigurasikan variabel lingkungan untuk semua pengguna. Anda harus menjalankan perintah berikut sebagai administrator.

[System.Environment]::SetEnvironmentVariable('MQTT_AK_ENV', 'LTAI****', [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable('MQTT_SK_ENV', 'EZJn****', [System.EnvironmentVariableTarget]::Machine)

Konfigurasikan variabel lingkungan sementara. Variabel lingkungan hanya berlaku untuk sesi saat ini.

$env:MQTT_AK_ENV = "LTAI****"
$env:MQTT_SK_ENV = "EZJn****"

Dalam PowerShell, jalankan perintah Get-ChildItem env:MQTT_AK_ENV dan Get-ChildItem env:MQTT_SK_ENV. Jika pasangan AccessKey yang dikembalikan valid, konfigurasi berhasil.

Penting

Referensi

Kode contoh disediakan hanya untuk referensi. Untuk informasi tentang cara memperoleh SDK untuk bahasa pemrograman tertentu, lihat Unduh SDK.

Variabel	Contoh
ID AccessKey	Nama variabel: MQTT_AK_ENV Nilai variabel: LTAI****
Rahasia AccessKey	Nama variabel: MQTT_SK_ENV Nilai variabel: EZJn****