using Dpz.Core.Entity.Base;
using Dpz.Core.MessageQueue.Abstractions;
using Dpz.Core.MessageQueue.Models;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
using RabbitMQ.Client;
using RabbitMQ.Client.Events;

namespace Dpz.Core.MessageQueue.RabbitMQ;

/// <summary>
/// RabbitMQ消息消费者后台服务
/// </summary>
/// <typeparam name="TMessage">消息类型</typeparam>
public class RabbitMQConsumerBackgroundService<TMessage>(
    IRabbitMQConnectionFactory connectionFactory,
    IMessageRoutingConvention routingConvention,
    IServiceProvider serviceProvider,
    IMessageOutboxStore outboxStore,
    ILoggerFactory loggerFactory
)
    : RabbitMQConsumerBackgroundServiceBase<TMessage>(
        connectionFactory,
        routingConvention,
        outboxStore,
        loggerFactory
    )
    where TMessage : MessageBase
{
    protected override async Task HandleMessageAsyncCore(
        TMessage message,
        BasicDeliverEventArgs eventArgs,
        IChannel channel,
        CancellationToken cancellationToken
    )
    {
        using var scope = serviceProvider.CreateScope();
        var handler = scope.ServiceProvider.GetRequiredService<IMessageHandler<TMessage>>();

        MessageHandlerResult result;
        try
        {
            result = await handler.HandleAsync(message, cancellationToken);
        }
        catch (Exception ex) when (!cancellationToken.IsCancellationRequested)
        {
            result = MessageHandlerResult.Fail(ex.Message);
        }

        await HandleResultAsync(message, result, eventArgs, channel, cancellationToken);
    }
}
⚠⚠    以下内容为AI分析的结果,请根据实际情况进行判断。

代码解释

这是一个基于 RabbitMQ 的消息消费者后台服务实现类,用于处理特定类型的消息。

类定义

public class RabbitMQConsumerBackgroundService<TMessage>
  • 泛型约束: TMessage 必须继承自 MessageBase
  • 继承: 继承自 RabbitMQConsumerBackgroundServiceBase<TMessage> 基类
  • 用途: 作为后台服务持续监听和消费 RabbitMQ 中的消息

构造函数(主构造函数)

使用 C# 12 的主构造函数语法,接收以下依赖项:

  1. IRabbitMQConnectionFactory - RabbitMQ 连接工厂
  2. IMessageRoutingConvention - 消息路由约定(定义队列、交换机等)
  3. IServiceProvider - 服务提供者(用于创建作用域)
  4. IMessageOutboxStore - 消息发件箱存储(可能用于消息持久化)
  5. ILoggerFactory - 日志工厂

这些依赖项会传递给基类构造函数。

核心方法:HandleMessageAsyncCore

这是消息处理的核心逻辑:

处理流程

  1. 创建服务作用域

    using var scope = serviceProvider.CreateScope();
    

    创建一个新的依赖注入作用域,确保每次消息处理都有独立的服务实例

  2. 获取消息处理器

    var handler = scope.ServiceProvider.GetRequiredService<IMessageHandler<TMessage>>();
    

    从作用域中获取具体消息类型对应的处理器

  3. 执行消息处理

    result = await handler.HandleAsync(message, cancellationToken);
    

    调用处理器的异步处理方法

  4. 异常处理

    catch (Exception ex) when (!cancellationToken.IsCancellationRequested)
    {
        result = MessageHandlerResult.Fail(ex.Message);
    }
    

    捕获处理过程中的异常(排除取消操作),将异常信息转换为失败结果

  5. 处理结果

    await HandleResultAsync(message, result, eventArgs, channel, cancellationToken);
    

    根据处理结果执行后续操作(如 ACK、NACK、重试等,具体逻辑在基类中)

设计特点

  • 关注点分离: 此类只负责消息的接收和协调,具体业务逻辑委托给 IMessageHandler<TMessage>
  • 依赖注入: 每次消息处理都创建新的作用域,避免服务实例共享问题
  • 异常安全: 统一的异常处理机制,确保消息不会因异常而丢失
  • 可扩展性: 泛型设计支持不同类型的消息处理
评论加载中...