RabbitMQ作为一款主流的消息队列工具早已广受欢迎。相比于其它的MQ工具,RabbitMQ支持的语言更多、功能更完善。
本文提供一种市面上最/极简单的使用RabbitMQ的方式(支持.NET/.NET Framework/.NET Core),只需要会调用以下三个方法,你就几乎可以掌握整个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服务器建立“长链接”。若要结束“长链接”,可在“任务管理器”中杀死进程。
使用消息服务对解耦分布式系统、实现发布/订阅、提高系统性能、等方面都有巨大用处,相信本文会扩展你的思维认知,让你在相关技术解决方案上有更多灵活思路+联想空间!
【附注】:文中所有示例均已成功运行通过!!技术交流/支持,请微信扫描二维码,备注“进群”!