ApsaraMQ for RocketMQ:Preparação do ambiente

SDK do .NET para Windows

O SDK para .NET é um wrapper gerenciado construído sobre a versão C++ do cliente ApsaraMQ for RocketMQ. Esse design garante que o SDK opere independentemente das bibliotecas públicas padrão do .NET para Windows. Internamente, ele utiliza processamento simultâneo multithread em C++ para assegurar alto desempenho e estabilidade.

Ao desenvolver aplicativos .NET e bibliotecas de classes no Visual Studio (VS), a plataforma de destino padrão é "Any CPU". Essa configuração permite executar o aplicativo em plataformas x86 ou x64, dependendo da arquitetura do processador. Em tempo de execução, o compilador Just-In-Time (JIT) do Common Language Runtime (CLR) converte o código Intermediate Language (IL) em código de máquina nativo x86 ou x64. Por outro lado, uma DLL gerada por um compilador C/C++ já é código de máquina, com a plataforma de destino definida na compilação. Ao definir as opções de compilação apropriadas, o projeto C/C++ gera uma DLL x64. Portanto, este SDK fornece uma DLL de 64 bits no modo de release, compilada com Visual Studio 2015 e .NET Framework 4.5.2. Essa DLL também é compatível com outras versões do Visual Studio.

Baixe o SDK do .NET para Windows

Baixe a versão mais recente do SDK. Para obter o link de download da versão mais recente do SDK para .NET, consulte Notas de versão.

Configure o SDK do .NET no Visual Studio 2015

1. Crie um projeto no Visual Studio 2015. Abra o Visual Studio 2015 e clique em New Project.... Na caixa de diálogo New Project, acesse Installed > Templates > Visual C# > Windows. Selecione Console Application, defina o framework de destino como .NET Framework 4.5.2, especifique um nome para o projeto e clique em OK.

2. Clique com o botão direito no projeto, selecione Add > Existing Item... e adicione todos os arquivos do diretório interface do pacote SDK baixado.

3. Clique com o botão direito no projeto e selecione Properties > Configuration Manager. Defina Active solution configuration como Release e Active solution platform como x64.

4. Escreva o programa de teste e compile-o. Para executar o programa, coloque os arquivos DLL do SDK no mesmo diretório do executável ou em um diretório do sistema. Após a compilação, localize os arquivos de runtime necessários, como ONSClient4CPP.dll, no diretório de saída, geralmente bin\x64\Release.

   Nota

   O SDK inclui um projeto de demonstração pré-configurado. Abra e compile esse projeto diretamente. Antes de executar o aplicativo, copie os arquivos DLL necessários para o mesmo diretório do executável.

   Os arquivos a copiar são ONSClient4CPP.dll, ONSClient4CPP.lib e ONSClient4CPP.pdb. O diretório de destino, como bin\Debug ou bin\Release, depende da configuração de build e da plataforma de destino.

Configure o ASP.NET no Visual Studio 2015 para usar o SDK do ApsaraMQ for RocketMQ

1. Crie um projeto ASP.NET Web Forms no Visual Studio 2015. No Visual Studio 2015, clique em New Project. Na árvore de modelos à esquerda, selecione Installed > Templates > Visual C#. Na lista de modelos, selecione ASP.NET Web Application, especifique o nome do projeto (por exemplo, WebApplication1), defina a versão do framework como .NET Framework 4.5.2 e clique em OK.

2. Clique com o botão direito no projeto e selecione Properties > Configuration Manager. Defina Active solution configuration como Release e Active solution platform como x64.

3. Clique com o botão direito no projeto, selecione Add > Existing Item... e adicione todos os arquivos do diretório interface do pacote SDK baixado.

   Para obter mais informações, consulte a Etapa 2 na seção "Configure o SDK do .NET no Visual Studio 2015".

4. Adicione o código para iniciar e encerrar o SDK no arquivo Global.asax.cs.

   Importante

   Envolva o código do SDK em uma classe singleton. Isso impede que o coletor de lixo colete o objeto prematuramente quando ele sair do escopo. O diretório example no pacote do SDK inclui Example.cs, que fornece uma implementação simples de singleton. Inclua Example.cs no projeto para usá-lo.

   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. Escreva o programa de teste e compile-o.

6. Para executar o programa, coloque os arquivos DLL do SDK no diretório bin do projeto. Após a compilação, verifique se o diretório de saída bin do projeto, como Projects\WebApplication4\WebApplication4\bin, contém os arquivos ONSClient4CPP.pdb, ONSClient4CPP.dll e ONSClient4CPP.lib.

7. Acesse Tools > Options > Projects and Solutions > Web Projects e marque a caixa de seleção **Use the 64-bit version of IIS Express for websites and projects**.