Net使用EasyNetQ简化与RabbitMQ的交互
EasyNetQ是一个为.NET环境设计的RabbitMQ客户端API,旨在简化与RabbitMQ的交互。
关于RabbitMq的更多知识点在:https://www.dotnetshare.com
公众号:Net分享,欢迎关注
安装EasyNetQ
你可以通过NuGet包管理器来安装EasyNetQ。在Package Manager Console中运行以下命令:
PM> Install-Package EasyNetQ
这将同时安装EasyNetQ和其依赖的RabbitMQ.Client库。
建议使用DI安装,EasyNetQ.DI.Microsof包含EasyNetQ,同时依赖Newtonsoft.Json
<PackageReference Include="EasyNetQ.DI.Microsoft" Version="7.8.0" />
<PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
注册连接RabbitMQ
var connectionString = "host=111.111.11.111;virtualHost=/;username=admin;password=123456;timeout=60";
//链接注册
builder.Services.RegisterEasyNetQ("host=8.153.70.182;virtualHost=/;username=zhaoke;password=123123;publisherConfirms=true");
//发布注册
builder.Services.AddTransient<MQPublish>();
//订阅注册
builder.Services.AddTransient<MQSubscribe>();
//添加消息处理
builder.Services.AddHostedService<SubscribeWorker>();
发布消息
EasyNetQ支持发布/订阅模式,你可以通过创建一个.NET类来定义消息,然后使用Publish
方法发布消息。例如:
public class TextMessage
{
public string Text {
get; set; }
}
bus.Publish(new TextMessage {
Text = "Hello World" });
EasyNetQ会根据消息类型自动创建交换机和队列,并使用Newtonsoft.Json序列化消息为JSON格式。
MQPublish的封装
using EasyNetQ.Topology;
using EasyNetQ;
/// <summary>
/// 发布消息
/// </summary>
public class MQPublish
{
private readonly IBus bus;
public MQPublish(IBus bus)
{
this.bus = bus;
}
/// <summary>
/// 发布消息
/// </summary>
/// <param name="routingKey"></param>
/// <param name="data"></param>
public async Task PublishMessageAsync(string routingKey, object data)
{
Console.WriteLine($"MQ消息推送,routingKey :{routingKey} , 推送数据 :{System.Text.Json.JsonSerializer.Serialize(data)}");
var message = new Message<object>(data);
var advancedBus = bus.Advanced;
advancedBus.QueueDeclare(routingKey);
await advancedBus.PublishAsync(Exchange.Default, routingKey, false, message);
}
/// <summary>
/// 发布延迟消息
/// </summary>
/// <param name="routingKey"></param>
/// <param name="data"></param>
/// <param name="timeout">毫秒</param>
public void PublishDelayMessage(string routingKey, object data, int timeout)
{
var advancedBus = bus.Advanced;
var message = new Message<object>(data);
var properties = new MessageProperties();
properties.Headers.Add("x-delay", timeout);
var messageData = new Message<object>(message, properties);
// 建立延时 exchange
var exDelay = advancedBus.ExchangeDeclare($"{routingKey}_delay_exchange", cfg => cfg.AsDelayedExchange(ExchangeType.Direct));
// 申明队列
var qNormal = advancedBus.QueueDeclare($"{routingKey}_delay_queue");
// 绑定,设置好 RoutingKey
advancedBus.Bind(exDelay, qNormal, routingKey);
bus.Advanced.Publish(exDelay, routingKey, false, messageData);
}
}
订阅消息
订阅消息时,你需要指定一个订阅ID和一个处理消息的委托。例如:
bus.Subscribe<TextMessage>("subscriptionId", message =>
{
Console.WriteLine("Received message: " + message.Text);
});
这样,当有消息发布到对应的交换机和队列时,你的订阅就会收到消息。
封装MQSubscribe
public class MQSubscribe
{
// MQ消息总线
private readonly IBus bus;
public MQSubscribe(IBus bus)
{
this.bus = bus;
}
/// <summary>
/// 处理消息的总入口
/// </summary>
/// <returns></returns>
public Task Init()
{
SubscribeTSysLogVis();
//程序不结束,等待输入
Console.WriteLine($"已启动(处理消息) {DateTime.UtcNow}");
return Task.CompletedTask;
}
private Task SubscribeTSysLogVis()
{
var advancedBus = bus.Advanced;
//订阅TSysLogVis日志 - 请不要在两次发布之间重复使用它
var queue = advancedBus.QueueDeclare("TSysLogVis");
advancedBus.Consume(queue, async (body, properties, info) =>
{
try
{
var message = Encoding.UTF8.GetString(body.ToArray());
//var data = JsonConvert.DeserializeObject<TSysLogVis>(message);
Console.WriteLine($"消息处理 {DateTime.Now} : {message}");
//db.Insertable(data).SplitTable().ExecuteReturnSnowflakeId();
}
catch (Exception ex)
{
// 处理异常,例如记录日志或重新抛出
Console.Error.WriteLine($"处理消息时发生异常: {ex}");
}
});
return Task.CompletedTask;
}
}
SubscribeWorker
启用订阅服务即可
public class SubscribeWorker : BackgroundService
{
private readonly MQSubscribe _Service;
public SubscribeWorker(MQSubscribe Service)
{
_Service = Service;
}
// 执行逻辑
protected override async Task ExecuteAsync(CancellationToken stoppingToken)
{
await _Service.Init();
}
}
以上是EasyNetQ的基本使用方法,它还支持请求/响应模式和发送/接收模式,以及其他高级功能。你可以通过阅读官方文档来获取更多信息。
基础知识
消息队列(Message Queue):Rabbit 是基于消息队列的中间件,它允许应用程序通过发送和接收消息来进行异步通信。
生产者(Producer)和消费者(Consumer):Rabbit 中的应用程序可以充当生产者和消费者的角色。生产者负责将消息发送到队列中,消费者则从队列中接收并处理消息。
队列(Queue):Rabbit 使用队列来存储消息。生产者将消息发送到队列中,而消费者从队列中接收消息进行处理。队列可以确保消息的顺序性和可靠性。
交换器(Exchange):交换器负责接收生产者发送的消息,并根据一定的规则将消息路由到特定的队列中。Rabbit 提供了不同类型的交换器,如直连交换器(Direct Exchange)、主题交换器(Topic Exchange)等。
绑定(Binding):绑定将队列与交换器进行关联,定义了消息从交换器路由到队列的规则。一个队列可以绑定到多个交换器上,一个交换器也可以将消息路由到多个队列上。
路由键(Routing Key):生产者在发送消息时需要指定一个路由键,交换器根据路由键来判断将消息路由到哪些队列。不同类型的交换器对路由键的处理方式有所不同。
持久化(Durability):Rabbit 支持消息的持久化,即将消息存储到磁盘中以防止消息丢失。可以将队列、交换器和消息设置为持久化。
可靠性投递(Reliable Delivery):Rabbit 提供了消息可靠性投递的机制,确保消息能够被消费者正确地接收和处理。包括消息的确认机制、消息的重试、消息的死信队列等。
发布/订阅(Publish/Subscribe)模式:Rabbit 支持发布/订阅模式,其中一个生产者可以将消息同时发送给多个消费者,每个消费者都会收到相同的消息副本。
ACK 机制:消费者收到消息后需要发送 ACK(确认)给 Rabbit 服务器,告知服务器消息已经被成功接收和处理,服务器可以将消息从队列中删除。
欢迎关注我的公众号“Net分享”,技术文章第一时间推送,随缘更新 , 分享一些你可能注意不到的细节。