ApsaraMQ for RocketMQ, birden fazla programlama dili için TCP ve HTTP protokollerini destekleyen SDK'lar sunar. Örnek sürümünüz, gereken özellikler ve tercih ettiğiniz protokol doğrultusunda bir SDK seçin.
Bir SDK sürümü seçin
Başlangıç noktası olarak 5.x gRPC SDK'yı kullanmanız önerilir. Bu SDK tüm yeni özellikleri destekler ve sürekli optimizasyon alır. gRPC SDK belirli bir özelliği kapsamıyorsa 5.x Remoting SDK'ya geçiş yapın.
Aşağıdaki tabloda mevcut tüm SDK sürümleri karşılaştırılmaktadır. ✅ = desteklenir, ❌ = desteklenmez.
|
|
||||||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Sınırlamalar
Aynı tüketici grubundaki tüm tüketiciler aynı protokolü destekleyen istemciler kullanmalıdır.
-
Aynı tüketici grubunda Remoting protokolü SDK'dan gRPC protokolü SDK'ya kademeli yükseltme gerçekleştirirken:
Sıralı mesajlar sunan tüketici grupları bu yükseltmeyi desteklemez.
Eşzamanlı olarak mesaj sunan tüketici grupları sorunsuz yükseltmeyi destekler. Yükseltme sırasında az sayıda mesaj yinelenebilir.
Bir tüketici grubu Remoting protokolü SDK ile başlayıp gRPC protokolü SDK'ya yükseldikten sonra tekrar Remoting protokolü SDK'ya geri dönerse sıralı mesajlar için tüketici ofseti geri alınabilir.
RocketMQ ONS TCP 2.x SDK yalnızca bazı bölgelerde kullanılabilir. Daha fazla bilgi için bkz. Sınırlamalar.
TCP protokolü SDK'ları
Açık kaynaklı RocketMQ'yu kod değişikliği yapmadan cloud'a geçirirken yalnızca Community Edition SDK'yı kullanın. Diğer tüm durumlar için ApsaraMQ for RocketMQ tarafından sağlanan Enterprise Edition SDK'yı kullanın. Enterprise Edition SDK daha fazla özellik ve daha yüksek kararlılık sunar.
Enterprise Edition TCP protokolü SDK'ları (ONS 1.x/2.x)
Java
C/C++
.NET
HTTP protokolü SDK'ları
HTTP protokolü SDK'ları (Enterprise Edition), TCP protokolü aracılığıyla kullanılamayan ek programlama dillerini kapsayan çoklu dil desteği için önerilir.
Enterprise Edition HTTP protokolü SDK'ları
Java
PHP
Go
Python
Node.js
C#
C++
TCP ve HTTP özellik karşılaştırması
TCP önerilen protokoldür. Yüksek aktarım performansı sunar, daha fazla mesajlaşma özelliğini destekler ve mesaj birikmesi ile tüketici ofsetini sıfırlama dahil zengin gözlemlenebilirlik sağlar. TCP programlama dilinizi desteklemiyorsa veya hafif erişim yeterliyse HTTP kullanın.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Kullanım notları
Uç nokta türünü SDK protokolüyle eşleştirin. TCP SDK, ApsaraMQ for RocketMQ örneğinin TCP uç noktasını gerektirir; HTTP SDK ise HTTP uç noktasını gerektirir.
Grup kimlikleri protokole özeldir ve protokoller arasında paylaşılamaz. TCP SDK'lar için bir TCP grup kimliği, HTTP SDK'lar için bir HTTP grup kimliği oluşturun.
-
TCP ve HTTP istemcileri birbirleriyle mesaj alışverişi yapabilir. Ancak HTTP XML serileştirme kullandığından mesaj özellikleri, içeriği, etiketleri ve anahtarları XML belirtimlerine uygun olmalıdır. Uyumsuz mesajları Base64 ile kodlayın.
NotXML belirtimleri için bkz. XML sözdizimi. XML'i doğrulamak için xml_validator gibi üçüncü taraf bir araç kullanın.
Hem TCP hem de HTTP için genel ve özel uç noktalar tüm bölgelerde mevcuttur. Üretim iş yükleri için ApsaraMQ for RocketMQ'ya sanal özel cloud (VPC) üzerinden erişin. Bölge arası erişim, şirket içi erişim veya Cloud Enterprise Network (CEN) kullanılamadığında İnternet erişimi için genel uç nokta kullanın. Genel uç nokta trafiği giden İnternet trafiği ücretlerine tabidir. Daha fazla bilgi için bkz. İnternet trafiği fiyatlandırma ayrıntıları.