麓野 发表于 2024-3-15 17:34:40

告别繁琐!1分钟带你构建RabbitMQ消息应用

支持.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的对应值)
 
下面,我们给出一个使用了上述SendMessage、GetMessage、UseMessage三个方法的示例。该示例的功能说明如下:

[*]先向RabbitMQ服务器上名为“aa”的队列发送了5个消息,
[*]然后从RabbitMQ服务器上的“aa”队列中获取,并打印出第1个消息,
[*]最后再连续从RabbitMQ服务器上的“aa”队列中获取剩余4个消息,并把它们写入名为fj.txt的文件。
代码如下:
using DeveloperSharp.RabbitMQ;--------------------------<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>static void Main(string[] args)<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>{<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    //发送5个消息(使用SendMessage)<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    RabbitMQHelper.SendMessage("aa", "世界1,你好!");<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    RabbitMQHelper.SendMessage("aa", "世界2,你好!");<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    RabbitMQHelper.SendMessage("aa", "世界3,你好!");<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    RabbitMQHelper.SendMessage("aa", "世界4,你好!");<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    RabbitMQHelper.SendMessage("aa", "世界5,你好!");<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    //获取1个消息(使用GetMessage)<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    string OneMessage = RabbitMQHelper.GetMessage("aa").Message;<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    Console.WriteLine(OneMessage);<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    //向fj.txt这个文本文件中写入4个消息(使用UseMessage)<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    RabbitMQHelper.UseMessage("aa", t =><appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>   {<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings><appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>System.IO.File.AppendAllText("D:/fj.txt", t.Message);<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings><appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>return true;<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    });<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>}运行结果如下:
【控制台显示出】:世界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 Header = null)//异步方法:SendMessageAsync(2)获取一个消息RabbitMQMessage GetMessage(string QueueName)//异步方法:GetMessageAsync(3)使用一个消息(连续使用)void UseMessage(string QueueName, Func Use)//异步方法:UseMessageAsync附加说明:    (I)Use返回值为true时,代表当前消息已被有效处理并会被服务器删除。然后程序自动进入下一条消息的使用。<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings> 若Use返回值为false时,代表当前消息未被有效处理但仍会被服务器删除。然后程序自动进入下一条消息的使用。<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings> 若Use返回值为null时,代表当前消息会被服务器重新队列分配到其它可用的实例上再处理。然后程序自动进入下一条消息的使用。<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings> 若Use内部发生未被处理的异常,程序会停止。    (II)RabbitMQMessage对象定义如下:<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>public class RabbitMQMessage<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>{<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>   public string Message;<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>   public IDictionary Header;<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>   public string Id; //此处系统自动生成的Id是分布式唯一Id。<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>}
最后说明一点:一旦调用三个方法,会与RabbitMQ服务器建立“长链接”。若要结束“长链接”,可在“任务管理器”中杀死进程。
 
2.延时队列 & 死信队列
有些场景下,我们希望为使用的消息设定有效期。在有效期内,这些消息有效可用;但过期后,这些消息将变得无效不可用,同时,它们还将自动被丢弃进一个称之为“死信”的队列。
为了说明这些概念,我们还是来举一个具体的例子。该例子的功能说明如下:

[*]首先,在RabbitMQ服务器上定义一个名为"bbq"、且其中存放的消息会在60秒后过期失效的队列。
[*]然后,在RabbitMQ服务器上定义一个与"bbq"队列对应的死信队列。并连续从该死信队列中获取消息并把它们写入名为BB.txt的文件。
[*]最后,向RabbitMQ服务器上的"bbq"队列发送3个消息。
 代码如下:
using DeveloperSharp.RabbitMQ;//从NuGet引用DeveloperSharp.RabbitMQ包--------------------------<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    //定义bbq队列,其中存放的消息会在60秒后过期<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    var myQ = RabbitMQHelper.SetQueue("bbq", 60000);<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    //定义与bbq队列对应的死信队列<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    var expQ = RabbitMQHelper.GetQueue("bbq");<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    //向BB.txt这个文本文件中连续写入死信队列中的消息<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    expQ.UseMessage(t =><appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    {<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings><appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>System.IO.File.AppendAllText("D:/BB.txt", t.Message);<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings><appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>return true;<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    });<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    //向bbq队列发送3个消息<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    myQ.SendMessage("jinA");<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    myQ.SendMessage("jinB");<appSettings>
    <add key="RabbitMQConnectionString" value="hostName=135.208.12.236,virtualHost=/,port=5672,userName=sa,password=aevin.gang" />
</appSettings>    myQ.SendMessage("jinC");
运行以上程序:
60秒之内,【BB.txt文件】中没有内容
60秒以后,【BB.txt文件】中显示出:jinAjinBjinC
 
通过以上例子,我们可简单预测一下,延时队列&死信队列常用在“限时消费”、“过期处理”等场景。生活中最常见示例如:订单请在10分钟内支付完毕、等等之类功能...
 
(其它说明:为了演示便利,文本前面给出的几个代码示例中,把SendMessage、GetMessage、UseMessage三个方法都放到了同一段代码程序中,这样做不好,偶尔会造成一些资源冲突。在实际使用中,最好是把它们分开分别放到三段不同的代码程序中,以获取最佳效果。比如:三个按钮、三个服务,之类...)
 
使用消息服务对解耦分布式系统、实现发布/订阅、提高系统性能、等方面都有巨大用处,相信本文会扩展你的思维认知,让你在相关技术解决方案上有更多灵活思路+联想空间!
 

来源:https://www.cnblogs.com/digital-college/p/18075317
免责声明:由于采集信息均来自互联网,如果侵犯了您的权益,请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容,谢谢合作!
页: [1]
查看完整版本: 告别繁琐!1分钟带你构建RabbitMQ消息应用