ApsaraMQ for RocketMQ:Persiapan lingkungan

Windows .NET SDK

SDK untuk .NET adalah wrapper managed yang dibangun di atas versi C++ dari client ApsaraMQ for RocketMQ. Desain ini memastikan bahwa SDK beroperasi secara independen dari pustaka publik standar Windows .NET. Secara internal, SDK menggunakan pemrosesan konkuren multithreaded C++ untuk menjamin kinerja tinggi dan stabilitas.

Saat mengembangkan aplikasi .NET dan pustaka kelas di Visual Studio (VS), platform target default-nya adalah "Any CPU". Pengaturan ini memungkinkan aplikasi berjalan di platform x86 atau x64, tergantung pada arsitektur prosesor. Saat runtime, kompilator Just-In-Time (JIT) dari Common Language Runtime (CLR) mengonversi kode Intermediate Language (IL) menjadi kode mesin native x86 atau x64. Sebaliknya, DLL yang dihasilkan oleh kompilator C/C++ sudah merupakan kode mesin, dengan platform target ditentukan saat waktu kompilasi. Dengan mengatur opsi kompilasi yang sesuai, proyek C/C++ dikompilasi menjadi DLL x64. Oleh karena itu, SDK ini menyediakan DLL 64-bit dalam mode release, dikompilasi dengan Visual Studio 2015 dan .NET Framework 4.5.2. DLL ini juga kompatibel dengan versi Visual Studio lainnya.

Unduh Windows .NET SDK

Unduh versi terbaru SDK. Untuk tautan unduhan versi terbaru SDK untuk .NET, lihat Catatan rilis.

Konfigurasikan .NET SDK di Visual Studio 2015

1. Buat proyek di Visual Studio 2015. Buka Visual Studio 2015 dan klik New Project.... Di kotak dialog New Project, navigasikan ke Installed > Templates > Visual C# > Windows. Pilih Console Application, atur framework target ke .NET Framework 4.5.2, tentukan nama proyek, lalu klik OK.

2. Klik kanan proyek, pilih Add > Existing Item..., lalu tambahkan semua file dari direktori interface pada paket SDK yang telah diunduh.

3. Klik kanan proyek dan pilih Properties > Configuration Manager. Atur Active solution configuration ke Release dan Active solution platform ke x64.

4. Tulis program uji Anda dan kompilasi. Untuk menjalankan program, letakkan file DLL SDK di direktori yang sama dengan executable atau di direktori sistem. Setelah kompilasi, Anda dapat menemukan file runtime yang diperlukan, seperti ONSClient4CPP.dll, di direktori output, biasanya bin\x64\Release.

   Catatan

   SDK mencakup proyek demo yang telah dikonfigurasi sebelumnya. Anda dapat langsung membuka dan mengompilasi proyek ini. Sebelum menjalankan aplikasi, salin file DLL yang diperlukan ke direktori yang sama dengan executable.

   File yang perlu disalin adalah ONSClient4CPP.dll, ONSClient4CPP.lib, dan ONSClient4CPP.pdb. Direktori tujuan, seperti bin\Debug atau bin\Release, bergantung pada konfigurasi build dan platform target Anda.

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

1. Buat proyek ASP.NET Web Forms di Visual Studio 2015. Di Visual Studio 2015, klik New Project. Di pohon templat di sebelah kiri, pilih Installed > Templates > Visual C#. Dari daftar templat, pilih ASP.NET Web Application, tentukan nama proyek (misalnya, WebApplication1), atur versi framework ke .NET Framework 4.5.2, lalu klik OK.

2. Klik kanan proyek dan pilih Properties > Configuration Manager. Atur Active solution configuration ke Release dan Active solution platform ke x64.

3. Klik kanan proyek, pilih Add > Existing Item..., lalu tambahkan semua file dari direktori interface pada paket SDK yang telah diunduh.

   Untuk informasi selengkapnya, lihat Langkah 2 pada bagian "Konfigurasikan SDK untuk .NET di Visual Studio 2015".

4. Tambahkan kode untuk memulai dan mematikan SDK di file Global.asax.cs.

   Penting

   Bungkus kode SDK dalam kelas singleton. Hal ini mencegah garbage collector mengumpulkan objek secara prematur ketika objek tersebut keluar dari cakupan. Direktori example dalam paket SDK mencakup Example.cs, yang menyediakan implementasi singleton sederhana. Anda harus menyertakan Example.cs dalam proyek Anda untuk menggunakannya.

   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 untuk kelas wrapper sederhana untuk SDK. Lihat Example.cs di direktori contoh SDK.
   namespace WebApplication4
   {
     public class Global : HttpApplication
     {
          void Application_Start(object sender, EventArgs e)
          {
              // Kode yang dijalankan saat aplikasi dimulai
              RouteConfig.RegisterRoutes(RouteTable.Routes);
              BundleConfig.RegisterBundles(BundleTable.Bundles);
              try
              {
                  // Kode untuk memulai SDK. Kode berikut menggunakan wrapper sederhana.
                  OnscSharp.CreateProducer();
                  OnscSharp.StartProducer();
              }
              catch (Exception ex)
              {
              // Tangani exception.
              }
          }
          protected void Application_End(object sender, EventArgs e)
          {
              try
              {
                 // Kode untuk mematikan SDK.
                OnscSharp.ShutdownProducer();
              }
              catch (Exception ex)
              { 
              // Tangani exception.
              }
          }
     }
   }                  

5. Tulis program uji Anda dan kompilasi.

6. Untuk menjalankan program, letakkan file DLL SDK di direktori bin proyek. Setelah kompilasi, pastikan direktori output bin proyek, seperti Projects\WebApplication4\WebApplication4\bin, berisi file ONSClient4CPP.pdb, ONSClient4CPP.dll, dan ONSClient4CPP.lib.

7. Navigasikan ke Tools > Options > Projects and Solutions > Web Projects, lalu centang kotak pilihan Use the 64-bit version of IIS Express for websites and projects.