Persiapan Lingkungan - ApsaraMQ for RocketMQ

Topik ini menjelaskan cara mempersiapkan lingkungan untuk mengakses ApsaraMQ for RocketMQ menggunakan SDK untuk .NET, sehingga Anda dapat mengirim dan menerima pesan dengan SDK tersebut.

Penting

Kami merekomendasikan penggunaan RocketMQ 5.x SDK terbaru. SDK ini sepenuhnya kompatibel dengan broker ApsaraMQ for RocketMQ 5.x dan menyediakan lebih banyak fungsi serta fitur yang ditingkatkan. Untuk informasi lebih lanjut, lihat Deskripsi Versi.
Alibaba Cloud hanya memelihara RocketMQ 4.x, 3.x, dan TCP client SDK. Kami merekomendasikan penggunaan SDK ini hanya untuk bisnis yang sudah ada.

Ikhtisar Windows SDK untuk .NET

Versi .NET yang disediakan oleh Alibaba Cloud merupakan enkapsulasi berbasis ApsaraMQ for RocketMQ versi C++. Ini memastikan bahwa .NET sepenuhnya independen dari pustaka umum .NET Windows. Pemrosesan konkuren multithread C++ digunakan secara internal untuk menjamin efisiensi dan stabilitas versi .NET.

Saat menggunakan Visual Studio untuk mengembangkan aplikasi dan pustaka kelas .NET, platform target default adalah AnyCPU. Ini berarti platform x86 atau x64 dapat dipilih secara otomatis berdasarkan jenis CPU. Selama runtime, Just-in-Time (JIT) compiler dalam common language runtime (CLR) .NET mengonversi kode IL menjadi kode mesin x86 atau x64. DLL yang dihasilkan oleh kompiler C atau C++ adalah kode mesin. Oleh karena itu, platform target dipilih selama kompilasi. Saat opsi kompilasi diatur, proyek C atau C++ dikompilasi sebagai DLL 64-bit x64. Dengan demikian, DLL 64-bit dalam mode rilis yang dikompilasi menggunakan Visual Studio 2015 dan .NET Framework 4.5.2 disediakan. DLL 64-bit dalam mode rilis juga tersedia untuk versi Visual Studio lainnya.

Penting

SDK untuk .NET hanya mendukung sistem operasi Windows 64-bit.
File DLL C++ memerlukan paket instalasi lingkungan runtime Visual C++ 2015. Jika lingkungan runtime Visual Studio 2015 belum diinstal, jalankan program vc_redist.x64.exe yang disediakan dalam SDK.

Unduh Windows SDK untuk .NET

Kami merekomendasikan baik pengguna baru maupun pengguna lama yang tidak mempermasalahkan biaya peningkatan untuk mengunduh SDK terbaru. Untuk informasi tentang URL unduhan versi terbaru SDK untuk .NET, lihat Catatan Rilis.

Unduh dan ekstrak paket tersebut. Struktur direktori berikut akan ditampilkan:

lib/
Berisi file terkait DLL C++ dasar dan paket instalasi lingkungan runtime Visual C++ 2015. Jika lingkungan runtime Visual Studio 2015 belum diinstal, salin kode berikut untuk menginstal program vc_redist.x64.exe:
```
  64/
      ONSClient4CPP.lib
      ONSClient4CPP.dll
      ONSClient4CPP.pdb
    vc_redist.x64.exe                    
```
demo/
Berisi contoh kode untuk mengirim pesan normal, pesan satu arah, dan pesan terurut. Direktori ini juga mencakup contoh kode untuk konsumsi pesan normal dan pesan terurut.
interface/
Mengenkapsulasi kode PInvoke. Kode ini harus dimasukkan dalam kode proyek Anda.
SDK_GUIDE.pdf
Berisi dokumentasi dan pertanyaan yang sering diajukan (FAQ) tentang cara menyiapkan lingkungan SDK.
changelog
Berisi perbaikan bug dan fitur baru dalam rilis baru.

Konfigurasi untuk menggunakan SDK untuk .NET di Visual Studio 2015

Gunakan Visual Studio 2015 untuk membuat proyek Anda.
Klik kanan proyek dan pilih Add > Add Existing Item untuk menambahkan semua file di direktori interface dari paket SDK yang diunduh.
Klik kanan proyek dan pilih Properties > Configuration Manager. Atur Active solution configuration ke Release dan atur Active solution platform ke x64.
Tulis dan kompilasi program uji, simpan file DLL SDK ke direktori file yang dapat dieksekusi atau ke direktori sistem, lalu jalankan program.
Catatan
SDK menyediakan proyek demo yang telah dikonfigurasi sebelumnya. Anda dapat langsung membuka proyek dan mengompilasinya. Saat menjalankan proyek, salin file DLL terkait berikut ke direktori file yang dapat dieksekusi:

Konfigurasi untuk menggunakan SDK ApsaraMQ for RocketMQ di Visual Studio 2015 ASP.NET

Buat proyek Web Forms untuk ASP.NET menggunakan Visual Studio 2015.
Klik kanan proyek dan pilih Properties > Configuration Manager. Atur Active solution configuration ke Release dan atur Active solution platform ke x64.
Klik kanan proyek dan pilih Add > Add Existing Item untuk menambahkan semua file di direktori interface dari paket SDK yang diunduh.
Untuk informasi lebih lanjut tentang cara mengonfigurasi proyek .NET umum, lihat Langkah 2.

Tambahkan kode untuk memulai dan menghentikan SDK ke file Global.asax.cs.

Penting

Kami merekomendasikan Anda mengenkapsulasi kode SDK sebagai kelas singleton sehingga kode tidak dapat didaur ulang oleh garbage collector karena masalah cakupan. Direktori contoh SDK berisi file Example.cs untuk mengimplementasikan kelas singleton sederhana. Untuk menggunakan Example.cs, Anda harus memasukkannya ke dalam proyek Anda sendiri.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Optimization;
using System.Web.Routing;
using System.Web.Security;
using System.Web.SessionState;
using ons;    // Namespace tempat SDK berada. 
using test;    // Namespace tempat kelas dengan SDK yang dienkapsulasi kasar berada. Lihat file Example.cs di direktori contoh SDK. 
namespace WebApplication4
{
  public class Global : HttpApplication
  {
       void Application_Start(object sender, EventArgs e)
       {
           // Kode yang berjalan saat startup aplikasi
           RouteConfig.RegisterRoutes(RouteTable.Routes);
           BundleConfig.RegisterBundles(BundleTable.Bundles);
           try
           {
               // Kode untuk memulai SDK. Kode berikut adalah kode setelah SDK dienkapsulasi kasar. 
               OnscSharp.CreateProducer();
               OnscSharp.StartProducer();
           }
           catch (Exception ex)
           {
           // Tangani kesalahan. 
           }
       }
       protected void Application_End(object sender, EventArgs e)
       {
           try
           {
              // Kode untuk menghentikan SDK. 
             OnscSharp.ShutdownProducer();
           }
           catch (Exception ex)
           { 
           // Tangani kesalahan 
           }
       }
  }
}

Tulis dan kompilasi program uji.
Simpan file DLL SDK ke direktori file yang dapat dieksekusi atau ke direktori sistem dan jalankan program.
Pilih Tools > Options > Projects and Solutions > Web Projects. Kemudian, pilih kotak centang Gunakan versi 64-bit dari IIS Express untuk situs web dan proyek.