.NET中大型項目開發必備(12)--使用MQ消息隊列

本文轉載自查看原文 2022-01-26 05:49 2221 C#/ RabbitMQ/ 使用RabbitMQ/ .NET/ 消息隊列/ 消息

前言：本系列文章適合有初/中級.NET知識的同學閱讀（請在電腦上打開頁面，獲取更好的閱讀效果）。
（1）本系列文章，旨在講述研發一個中大型項目所需要了解的一系列“基本構件”，並提供這些“基本構件”在全網的【最簡單】、【最快速】使用方法！！（並不深究技術原理）
（2）通過閱讀本系列文章，能讓你在正規“項目研發”方面快速入門+進階，並能達成“小團隊構建大網站”的目的。
（3）本系列文章采用的技術，已成功應用到人工智能、產業互聯網、社區電商、游戲、金融風控、智慧醫療、等項目上。

支持.Net/.Net Core/.Net Framework，可以部署在Docker, Windows, Linux, Mac。

RabbitMQ作為一款主流的消息隊列工具早已廣受歡迎。相比於其它的MQ工具，RabbitMQ支持的語言更多、功能更完善。

1.發送消息、獲取消息、使用消息

本文提供一種市面上最/極簡單的使用RabbitMQ的方式，只需要會調用以下三個方法，你就幾乎可以掌握整個RabbitMQ的使用：

（1） SendMessage，發送一個消息

（2） GetMessage，獲取一個消息

（3） UseMessage，使用一個消息（連續使用）

為了調用以上三個方法，首先需要從NuGet引用DeveloperSharp.RabbitMQ包。

然后，對RabbitMQ消息服務器的鏈接信息進行配置（分.Net Core與.Net Framework兩種情況）：

若是在.Net Core環境下，你則需要在DeveloperSharp.json文件中添加“DeveloperSharp.RabbitMQ”節點（如下配置示例），並把DeveloperSharp.json文件放到程序執行目錄中（即bin目錄下與dll、exe等文件的同一目錄中，放錯了位置會報錯）（注意：有些.Net Core版本在Visual Studio“調試”時，不會在bin目錄下生成全部的dll、exe，此時需要把此配置文件放在應用程序的“根目錄”下）。

{
  "DeveloperSharp.RabbitMQ":[{
    "HostName":"135.208.12.236",
    "VirtualHost":"/",
    "UserName":"sa",
    "Password":"aevin.gang",
    "Port":5672
  }]
}

若是在.Net Framework環境下，你則需要在App.config/Web.config里面添加如下配置：

  <appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
  </appSettings>

說明：上述配置中分別設置了RabbitMQ應用所在的服務器IP地址hostName、虛擬主機virtualHost、端口port、用戶名userName、密碼password（請把這五項的對應值修改成你自己那邊的RabbitMQ的對應值）

（注意：DeveloperSharp.RabbitMQ包在7.0版本以前，.Net Core下也支持App.config/Web.config配置。但在7.0及以后版本中，.Net Core下只支持appsettings.json文件配置）

下面，我們給出一個使用了上述SendMessage、GetMessage、UseMessage三個方法的示例。該示例的功能說明如下：

先向RabbitMQ服務器上名為“aa”的隊列發送了5個消息，
然后從RabbitMQ服務器上的“aa”隊列中獲取，並打印出第1個消息，
最后再連續從RabbitMQ服務器上的“aa”隊列中獲取剩余4個消息，並把它們寫入名為fj.txt的文件。

代碼如下：

using DeveloperSharp.RabbitMQ;
--------------------------

        static void Main(string[] args)
        {
            //發送5個消息（使用SendMessage）
            RabbitMQHelper.SendMessage("aa", "世界1，你好！");
            RabbitMQHelper.SendMessage("aa", "世界2，你好！");
            RabbitMQHelper.SendMessage("aa", "世界3，你好！");
            RabbitMQHelper.SendMessage("aa", "世界4，你好！");
            RabbitMQHelper.SendMessage("aa", "世界5，你好！");

            //獲取1個消息（使用GetMessage）
            string OneMessage = RabbitMQHelper.GetMessage("aa").Message;
            Console.WriteLine(OneMessage);

            //向fj.txt這個文本文件中寫入4個消息（使用UseMessage）
            RabbitMQHelper.UseMessage("aa", t => 
            {
                System.IO.File.AppendAllText("D:/fj.txt", t.Message);
                return true;
            });
        }

運行結果如下：

【控制台顯示出】：世界1，你好！

【fj.txt文件中顯示出】：世界2，你好！世界3，你好！世界4，你好！世界5，你好！

（上述示例中，由於SendMessage是同步方法，故“世界1，你好！”~“世界5，你好！”會按順序顯示。若我們把SendMessage方法全部改為異步的SendMessageAsync，則顯示結果將不再是按順序來的，很有可能顯示成類似這樣：“世界3，你好！世界1，你好！世界5，你好！世界2，你好！世界4，你好！”）

三個方法的詳細功能說明（輔助參考）：

（1）發送一個消息
void SendMessage(string QueueName, string Message, Dictionary<string, object> Header = null)
//異步方法：SendMessageAsync

（2）獲取一個消息
RabbitMQMessage GetMessage(string QueueName)
//異步方法：GetMessageAsync

（3）使用一個消息（連續使用）
void UseMessage(string QueueName, Func<RabbitMQMessage, bool?> Use)
//異步方法：UseMessageAsync
附加說明：
    （I）Use返回值為true時，代表當前消息已被有效處理並會被服務器刪除。然后程序自動進入下一條消息的使用。
         若Use返回值為false時，代表當前消息未被有效處理但仍會被服務器刪除。然后程序自動進入下一條消息的使用。
         若Use返回值為null時，代表當前消息會被服務器重新隊列分配到其它可用的實例上再處理。然后程序自動進入下一條消息的使用。
         若Use內部發生未被處理的異常，程序會停止。
    （II）RabbitMQMessage對象定義如下：
          public class RabbitMQMessage
          {
             public string Message;
             public IDictionary<string, object> Header;
             public string Id; //此處系統自動生成的Id是分布式唯一Id。
          }
    （III）RabbitMQMessage.Header字典中，實際值為string類型的object值，需要通過字節轉換才能變為字符串。
           例如：Encoding.UTF8.GetString((byte[])p.Header["Content"])

最后說明一點：一旦調用三個方法，會與RabbitMQ服務器建立“長鏈接”。若要結束“長鏈接”，可在“任務管理器”中殺死進程。

2.延時隊列 & 死信隊列

有些場景下，我們希望為使用的消息設定有效期。在有效期內，這些消息有效可用；但過期后，這些消息將變得無效不可用，同時，它們還將自動被丟棄進一個稱之為“死信”的隊列。

為了說明這些概念，我們還是來舉一個具體的例子。該例子的功能說明如下：

首先，在RabbitMQ服務器上定義一個名為"bbq"、且其中存放的消息會在60秒后過期失效的隊列。
然后，在RabbitMQ服務器上定義一個與"bbq"隊列對應的死信隊列。並連續從該死信隊列中獲取消息並把它們寫入名為BB.txt的文件。
最后，向RabbitMQ服務器上的"bbq"隊列發送3個消息。

代碼如下：

using DeveloperSharp.RabbitMQ;//從NuGet引用DeveloperSharp.RabbitMQ包
--------------------------

            //定義bbq隊列，其中存放的消息會在60秒后過期
            var myQ = RabbitMQHelper.SetQueue("bbq", 60000);

            //定義與bbq隊列對應的死信隊列
            var expQ = RabbitMQHelper.GetQueue("bbq");
            //向BB.txt這個文本文件中連續寫入死信隊列中的消息
            expQ.UseMessage(t =>
            {
                System.IO.File.AppendAllText("D:/BB.txt", t.Message);
                return true;
            });

            //向bbq隊列發送3個消息
            myQ.SendMessage("jinA");
            myQ.SendMessage("jinB");
            myQ.SendMessage("jinC");

            /*
            //【附加題】：若去掉注釋讓此語句執行，死信隊列中將不會獲得消息(為啥？自己推理)
            RabbitMQHelper.UseMessage("bbq", t =>
            {
                return true;//若此處返回false，死信隊列將會獲得消息
            });
            */

運行以上程序：

60秒之內，【BB.txt文件】中沒有內容

60秒以后，【BB.txt文件】中顯示出：jinAjinBjinC

通過以上例子，我們可簡單預測一下，延時隊列&死信隊列常用在“限時消費”、“過期處理”等場景。生活中最常見示例如：訂單請在10分鍾內支付完畢、等等之類功能...

（其它說明：為了演示便利，文本前面給出的幾個代碼示例中，把SendMessage、GetMessage、UseMessage三個方法都放到了同一段代碼程序中，這樣做不好，偶爾會造成一些資源沖突。在實際使用中，最好是把它們分開分別放到三段不同的代碼程序中，以獲取最佳效果。比如：三個按鈕、三個服務，之類...）

使用消息服務對解耦分布式系統、實現發布/訂閱、提高系統性能、等方面都有巨大用處，相信本文會擴展你的思維認知，讓你在相關技術解決方案上有更多靈活思路+聯想空間！

【附注】：下載示例均已成功運行通過。但有些輔助設置需要自己調整。技術支持+獲取更多寶貴資源：請微信掃描文末二維碼，備注“進群”！

推薦閱讀

免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。