Menyiapkan lingkungan - ApsaraMQ for RocketMQ

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

Sebelum menggunakan SDK untuk .NET, perhatikan hal-hal berikut:

Aplikasi yang menggunakan ApsaraMQ for RocketMQ harus diterapkan pada Alibaba Cloud Elastic Compute Service (ECS).
Buka konsol untuk membuat topik dan ID grup yang dirujuk dalam kode. Tag pesan dapat ditentukan oleh pengguna aplikasi. Untuk informasi lebih lanjut tentang cara membuat tag pesan, lihat Buat Sumber Daya.

Windows SDK untuk .NET gambaran

SDK untuk .NET yang disediakan oleh Alibaba Cloud adalah pembungkus terkelola untuk ApsaraMQ for RocketMQ SDK untuk C++. Hal ini memastikan bahwa SDK untuk .NET sepenuhnya independen dari pustaka publik Windows SDK untuk .NET. Pemrosesan multi-thread C++ digunakan untuk memastikan efisiensi dan stabilitas SDK untuk .NET.

Ketika Visual Studio digunakan untuk mengembangkan aplikasi dan pustaka kelas .NET, platform target defaultnya adalah AnyCPU. Ini berarti bahwa platform x86 atau x64 dapat dipilih secara otomatis berdasarkan jenis CPU. Selama runtime, Just-in-Time (JIT) compiler di 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. Oleh karena itu, 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

Pengguna baru dan pengguna yang sudah ada yang tidak peduli dengan biaya peningkatan disarankan untuk mengunduh versi terbaru SDK untuk .NET. Untuk informasi tentang URL unduhan untuk 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. File SDK aktual dapat bervariasi berdasarkan versi SDK yang Anda unduh.
```
  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 ApsaraMQ for RocketMQ SDK 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.

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-kelas wrapper SDK berada. 
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 secara kasar. 
               OnscSharp.CreateProducer();
               OnscSharp.StartProducer();
           }
           catch (Exception ex)
           {
           // Penanganan pengecualian. 
           }
       }
       protected void Application_End(object sender, EventArgs e)
       {
           try
           {
              // Kode untuk menghentikan SDK. 
             OnscSharp.ShutdownProducer();
           }
           catch (Exception ex)
           { 
           // Penanganan pengecualian. 
           }
       }
  }
}

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 Use the 64 bit version of IIS Express untuk situs web dan proyek.