ApsaraMQ for RocketMQ:Préparation de l'environnement

SDK .NET pour Windows

Le SDK .NET est un wrapper managé construit au-dessus de la version C++ du client ApsaraMQ for RocketMQ. Cette conception garantit que le SDK fonctionne indépendamment des bibliothèques publiques standard de Windows .NET. En interne, il utilise un traitement concurrent multithread en C++ pour assurer des performances élevées et une grande stabilité.

Lorsque vous développez des applications et des bibliothèques de classes .NET dans Visual Studio (VS), la plateforme cible par défaut est « Any CPU ». Ce paramètre permet à l'application de s'exécuter sur des plateformes x86 ou x64, selon l'architecture du processeur. Au moment de l'exécution, le compilateur Just-In-Time (JIT) du Common Language Runtime (CLR) convertit le code Intermediate Language (IL) en code machine natif x86 ou x64. En revanche, une DLL générée par un compilateur C/C++ est déjà du code machine, la plateforme cible étant déterminée lors de la compilation. En définissant les options de compilation appropriées, le projet C/C++ est compilé en une DLL x64. Par conséquent, ce SDK fournit une DLL 64 bits en mode Release, compilée avec Visual Studio 2015 et .NET Framework 4.5.2. Cette DLL est également compatible avec d'autres versions de Visual Studio.

Téléchargement du SDK .NET pour Windows

Téléchargez la dernière version du SDK. Pour obtenir le lien de téléchargement de la dernière version du SDK .NET, consultez les Notes de version.

Configuration du SDK .NET dans Visual Studio 2015

1. Créez un projet dans Visual Studio 2015. Ouvrez Visual Studio 2015 et cliquez sur New Project.... Dans la boîte de dialogue New Project, accédez à Installed > Templates > Visual C# > Windows. Sélectionnez Console Application, définissez le framework cible sur .NET Framework 4.5.2, spécifiez un nom de projet, puis cliquez sur OK.

2. Cliquez avec le bouton droit sur le projet, sélectionnez Add > Existing Item..., et ajoutez tous les fichiers du répertoire interface du package SDK téléchargé.

3. Cliquez avec le bouton droit sur le projet et sélectionnez Properties > Configuration Manager. Définissez Active solution configuration sur Release et Active solution platform sur x64.

4. Rédigez votre programme de test et compilez-le. Pour exécuter le programme, placez les fichiers DLL du SDK dans le même répertoire que l'exécutable ou dans un répertoire système. Après la compilation, vous trouverez les fichiers d'exécution requis, tels que ONSClient4CPP.dll, dans le répertoire de sortie, qui est généralement bin\x64\Release.

   Remarque

   Le SDK inclut un projet de démonstration préconfiguré. Vous pouvez ouvrir et compiler ce projet directement. Avant d'exécuter l'application, copiez les fichiers DLL requis dans le même répertoire que l'exécutable.

   Les fichiers à copier sont ONSClient4CPP.dll, ONSClient4CPP.lib et ONSClient4CPP.pdb. Le répertoire de destination, tel que bin\Debug ou bin\Release, dépend de votre configuration de build et de la plateforme cible.

Configuration d'ASP.NET dans Visual Studio 2015 pour utiliser le SDK ApsaraMQ for RocketMQ

1. Créez un projet ASP.NET Web Forms dans Visual Studio 2015. Dans Visual Studio 2015, cliquez sur New Project. Dans l'arborescence des modèles à gauche, sélectionnez Installed > Templates > Visual C#. Dans la liste des modèles, sélectionnez ASP.NET Web Application, spécifiez le nom du projet (par exemple, WebApplication1), définissez la version du framework sur .NET Framework 4.5.2, puis cliquez sur OK.

2. Cliquez avec le bouton droit sur le projet et sélectionnez Properties > Configuration Manager. Définissez Active solution configuration sur Release et Active solution platform sur x64.

3. Cliquez avec le bouton droit sur le projet, sélectionnez Add > Existing Item..., et ajoutez tous les fichiers du répertoire interface du package SDK téléchargé.

   Pour plus d'informations, consultez l'étape 2 de la section « Configuration du SDK .NET dans Visual Studio 2015 ».

4. Ajoutez le code pour démarrer et arrêter le SDK dans le fichier Global.asax.cs.

   Important

   Encapsulez le code du SDK dans une classe singleton. Cela empêche le garbage collector de collecter prématurément l'objet lorsqu'il sort de la portée. Le répertoire example du package SDK inclut Example.cs, qui fournit une implémentation singleton simple. Vous devez inclure Example.cs dans votre projet pour l'utiliser.

   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;    // The namespace where the SDK is located.
   using test;   // The namespace for a simple wrapper class for the SDK. See Example.cs in the SDK example directory.
   namespace WebApplication4
   {
     public class Global : HttpApplication
     {
          void Application_Start(object sender, EventArgs e)
          {
              // Code that runs on application startup
              RouteConfig.RegisterRoutes(RouteTable.Routes);
              BundleConfig.RegisterBundles(BundleTable.Bundles);
              try
              {
                  // Code to start the SDK. The following code uses a simple wrapper.
                  OnscSharp.CreateProducer();
                  OnscSharp.StartProducer();
              }
              catch (Exception ex)
              {
              // Handle exceptions.
              }
          }
          protected void Application_End(object sender, EventArgs e)
          {
              try
              {
                 // Code to shut down the SDK.
                OnscSharp.ShutdownProducer();
              }
              catch (Exception ex)
              { 
              // Handle exceptions.
              }
          }
     }
   }                  

5. Rédigez votre programme de test et compilez-le.

6. Pour exécuter le programme, placez les fichiers DLL du SDK dans le répertoire bin du projet. Après la compilation, vérifiez que le répertoire de sortie bin du projet, tel que Projects\WebApplication4\WebApplication4\bin, contient les fichiers ONSClient4CPP.pdb, ONSClient4CPP.dll et ONSClient4CPP.lib.

7. Accédez à Tools > Options > Projects and Solutions > Web Projects, puis cochez la case **Use the 64-bit version of IIS Express for websites and projects**.