RabbitMQ学习笔记
1.安装包
1.从NuGet引用DeveloperSharp.RabbitMQ包
2.服务器配置
2.1 .NetCore环境下配置
1 在appsettings.json文件中添加“DeveloperSharp.RabbitMQ”节点(如下配置示例);
{
“DeveloperSharp.RabbitMQ”:[{
“HostName”:“135.208.12.236”,
“UserName”:“sa”,
“Password”:“aevin.gang”,
“Port”:5672
}]
}
2 appsettings.json文件放到程序执行目录中(即bin目录下与dll、exe等文件的同一目录中)(放错了位置会报错)
2.2 .Net Framework环境下配置
1.在App.config/Web.config里面添加如下配置:
<appSettings>
<add key="RabbitMQConnectionString" value="hostName=135.208.12.236,port=5672,userName=sa,password=aevin.gang" />
<appSettings>
3.示例
下面,我们给出一个使用了上述SendMessage、GetMessage、UseMessage三个方法的示例。
同步方法代码如下:
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;
});
}
说明:先向RabbitMQ服务器上名为“aa”的队列发送了5个消息, 然后从RabbitMQ服务器上的“aa”队列中获取,并打印出第1个消息,最后再连续从RabbitMQ服务器上的“aa”队列中获取剩余4个消息,并把它们写入名为fj.txt的文件。
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<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。
}
5.延时队列&死信队列
有些场景下,我们希望为使用的消息设定有效期。在有效期内,这些消息有效可用;但过期后,这些消息将变得无效不可用,同时,它们还将自动被丢弃进一个称之为“死信”的队列.eg:
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,死信队列将会获得消息
});
*/
说明如下:
首先,在RabbitMQ服务器上定义一个名为"bbq"、且其中存放的消息会在60秒后过期失效的队列。
然后,在RabbitMQ服务器上定义一个与"bbq"队列对应的死信队列。并连续从该死信队列中获取消息并把它们写入名为BB.txt的文件。
最后,向RabbitMQ服务器上的"bbq"队列发送3个消息。