本文技術源自外企,並已在多個世界500強大型項目開發中運用。 本文適合有初/中級.NET知識的同學閱讀。(支持.NET/.NET Framework/.NET Core) RabbitMQ作為一款主流的消息隊列工具早已廣受歡迎。相比於其它的MQ工具,RabbitMQ支持的語言更多、功能更完善。 本文 ...
本文技術源自外企,並已在多個世界500強大型項目開發中運用。
本文適合有初/中級.NET知識的同學閱讀。(支持.NET/.NET Framework/.NET Core)
RabbitMQ作為一款主流的消息隊列工具早已廣受歡迎。相比於其它的MQ工具,RabbitMQ支持的語言更多、功能更完善。
本文提供一種市面上最/極簡單的使用RabbitMQ的方式,只需要會調用以下三個方法,你就幾乎可以掌握整個RabbitMQ的使用:
(1) SendMessage,發送一個消息
(2) GetMessage,獲取一個消息
(3) UseMessage,使用一個消息(連續使用)
為了調用以上三個方法,首先需要從nuget引用DeveloperSharp.RabbitMQ,併在App.config/Web.config裡面添加如下配置(.NET6 / VS2022中已有App.config這個添加單項):
<appSettings> <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,port=5672,userName=sa,password=aevin.gang" /> </appSettings>
說明:上述配置中分別設置了RabbitMQ應用所在的伺服器IP地址hostName、埠port、用戶名userName、密碼password(請把這四項的對應值修改成你自己那邊的RabbitMQ的對應值)
下麵,我們給出一個使用了上述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,你好!
三個方法的詳細功能說明(輔助參考):
(1)發送一個消息 void SendMessage(string QueueName, string Message, Dictionary<string, object> Header = null) (2)獲取一個消息 RabbitMQMessage GetMessage(string QueueName) (3)使用一個消息(連續使用) void UseMessage(string QueueName, Func<RabbitMQMessage, bool?> Use) 附加說明: (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具有UUID的特性。 } (III)RabbitMQMessage.Header字典中,實際值為string類型的object值,需要通過位元組轉換才能變為字元串。 例如:Encoding.UTF8.GetString((byte[])p.Header["Content"])
最後說明一點:一旦調用三個方法,會與RabbitMQ伺服器建立“長鏈接”。若要結束“長鏈接”,可在“任務管理器”中殺死進程。
使用消息服務對解耦分散式系統、實現發佈/訂閱、提高系統性能、等方面都有巨大用處,相信本文會擴展你的思維認知,讓你在相關技術解決方案上有更多靈活思路+聯想空間!
【附註】:文中所有示例均已成功運行通過!!技術交流/支持,請微信掃描二維碼,備註“進群”!