Net使用EasyNetQ简化与RabbitMQ的交互

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

注册连接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();
//订阅注册
builder.Services.AddTransient();
//添加消息处理
builder.Services.AddHostedService();
发布消息
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;

///

/// 发布消息

///

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("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分享”，技术文章第一时间推送，随缘更新 , 分享一些你可能注意不到的细节。