SuperAPI AI 工具集

messaging

通用与其它

查看项目

更新于 10-15 19:51

技能介绍

用途:为 .NET 应用提供异步消息传递的实践模式,覆盖模块间通信、可靠事件发布与工作流编排。

主要能力:介绍 Wolverine(MIT 许可,集合 mediator 与消息传递,内置 outbox、saga、约定式处理器)与 MassTransit(成熟替代方案,v9 起需商业许可)两种框架;讲解事务性 outbox 保证消息仅在数据库事务成功后发布;说明用事件编排(choreography)处理简单流程、用 saga 处理带补偿动作的复杂流程;给出消息契约、发布与消费、saga 状态编排及反模式要点。

使用方式:在 Program.cs 中调用 builder.Host.UseWolverine(opts => { ... }),配置 opts.Discovery.IncludeAssembly、opts.UseRabbitMq、AutoProvision()、AutoPurgeOnStartup()(仅开发);用 opts.Services.AddDbContextWithWolverineIntegration<AppDbContext>(...) 集成 EF Core,并设置 opts.Policies.AutoApplyTransactions();在 DbContext 的 OnModelCreating 中调用 modelBuilder.AddIncomingWolverineMessageTable() 与 AddOutgoingWolverineMessageTable()。发布可用级联消息(处理器返回消息即自动发布)或 IMessageBus.PublishAsync;消费只需公开的 Handle/HandleAsync 方法,消息类型为第一个参数。Saga 继承 Saga<T>,用 Start 与 Handle 方法驱动流程,MarkCompleted() 结束。MassTransit 侧用 AddMassTransit、UsingRabbitMq、AddEntityFrameworkOutbox 等 API。

适用场景:模块间通信、可靠事件发布、简单 2-3 步工作流、复杂带补偿的工作流、本地(RabbitMQ via Docker/Aspire)与云端(Azure Service Bus 或 RabbitMQ)代理。

限制:MassTransit v9 起生产使用需商业许可,新项目推荐 MIT 的 Wolverine;AutoPurgeOnStartup 仅限开发;应避免无 outbox 发布、在消息契约中放复杂逻辑、对重要事件使用即发即弃。具体源码与完整示例见原文链接。