迁移指南：从 Brighter V9 升级到 V10

最新推荐文章于 2026-01-04 19:49:59 发布

原创最新推荐文章于 2026-01-04 19:49:59 发布 · 884 阅读

11 ·

CC 4.0 BY-SA版权

文章标签：

#c# #brighter #.net

在[之前的文章中，我讨论了 Brighter V10 及其新特性。本篇补充文章重点介绍从 V9 到 V10 的必要迁移路径，强调重大变更并提供更新的代码示例。

依赖注入注册

您将遇到的第一个也是最重要的变化之一是 Brighter 如何注册到 Microsoft DI 容器中。AddServiceActivator 方法已被弃用，取而代之的是针对消费者和生产者的更具体方法。

消息消费者和生产者设置

在 V9 中，您通常对消费者使用 AddServiceActivator。在 V10 中，此注册现在明确拆分为 AddConsumers 和 AddProducers，使您可以更精细地控制。

另外请注意，opt.ChannelFactory 已重命名为 opt.DefaultChannelFactory。

services
    .AddServiceActivator(opt => 
    {
        opt.Subscriptions = [...];
        opt.ChannelFactory = new ChannelFactory(...);
    })
    .UseExternalBus(...)

V10

services
    .AddConsumers(opt => 
    {
        opt.Subscriptions = [...];
        opt.DefaultChannelFactory = new ChannelFactory(...);
    })
    .AddProducers(opt =>
    {
        opt.ProducerRegistry = ....
    });

收件箱和发件箱配置

以前，您通过在 AddServiceActivator 后链接 UseInMemoryInbox() 等方法来配置收件箱和发件箱。在 V10 中，此配置已直接移至 AddConsumers（用于收件箱）和 AddProducers（用于发件箱）选项中。

在 V10 中配置发件箱时，您现在还必须显式配置 ConnectionProvider 和 TransactionProvider。

services
    .AddServiceActivator(opt => 
    {
        opt.Subscriptions = [...];
        opt.ChannelFactory = new ChannelFactory(...);
    })
    .UseInMemoryInbox()
    .UseInMemoryOutbox()
    .UseExternalBus(...)

V10

services
    .AddConsumers(opt => 
    {
        opt.Subscriptions = [...];
        opt.InboxConfiguration = new InboxConfiguration(...);
        opt.DefaultChannelFactory = new ChannelFactory(...);
    })
    .AddProducers(opt =>
    {
        opt.ProducerRegistry = ....;
        opt.Outbox = ...;
        opt.ConnectionProvider = typeof(...);
        opt.TransactionProvider = typeof(...);
    });

组件生命周期

在 V10 中，强烈建议将消息映射器（Message Mappers）、转换器（Transformers）和请求处理器（Request Handlers）注册为 Scoped 或 Transient。

这是因为这些组件现在通常包含 RequestContext 属性。该属性在运行时（方法调用前）由框架更新，使用 Singleton 生命周期可能导致并发问题和数据过期。

消息映射器接口

IAmAMessageMapper 接口有两个关键的重大变更。

1. MapToMessage 签名：该方法现在包含一个 Publication 参数：MapToMessage(Greeting request, Publication publication)。这是支持新的默认映射器功能所必需的。
2. RequestContext 属性：接口现在要求一个 public IRequestContext? Context { get; set; } 属性。这允许框架或请求者在运行时传递额外的上下文和数据。

public class GreetingMapper : IAmAMessageMapper<Greeting>
{
    public Message MapToMessage(Greeting request)
    {
        var header = new MessageHeader();
        header.Id = request.Id;
        header.TimeStamp = DateTime.UtcNow;
        header.Topic = "greeting.topic";
        header.MessageType = MessageType.MT_EVENT;

        var body = new MessageBody(JsonSerializer.Serialize(request));
        return new Message(header, body);
    }

    public Greeting MapToRequest(Message message)
    {
        return JsonSerializer.Deserialize<Greeting>(message.Body.Bytes)!;
    }
}

V10

public class GreetingMapper : IAmAMessageMapper<Greeting>
{
    public IRequestContext? Context { get; set; }

    public Message MapToMessage(Greeting request, Publication publication)
    {
        var header = new MessageHeader();
        header.Id = request.Id;
        header.TimeStamp = DateTime.UtcNow;
        header.Topic = "greeting.topic";
        header.MessageType = MessageType.MT_EVENT;

        var body = new MessageBody(JsonSerializer.Serialize(request));
        return new Message(header, body);
    }

    public Greeting MapToRequest(Message message)
    {
        return JsonSerializer.Deserialize<Greeting>(message.Body.Bytes)!;
    }
}