前言
asp.net core版本选择2.2，只是因为个人习惯了vs2017，代码以及设计皆可移植到vs2019，用asp.net core 3.0以及以上运行起来
项目类似选择web api，基础设施选择entity frame core + Masstransit + aspectCore
先赘述一下思路业务，中间通讯以及容错/重试交给masstransit，部分流程的解耦交给aspectCore来完成，这部分包括，错误后通过masstransit发布给错误处理的模块，最后落盘到ef core
整个过程，业务处理的层之间可以通过Masstransit的通讯，可采用rpc的模式，也可以同异步的发布订阅通讯
整体设计是可单体可分布式的理念，可以根据项目变化，可以自行配置，拆分成完成单体到分布式的过程，完成业务分解，但是对于业务使用而言，都是一样的，无感知。
刚开始的文章会有很多代码段说明，属于前置知识的铺垫，可能会有些啰嗦，后续文章会忽略掉无关的大片代码段。
业务演示，我们选择传统的银行转账业务以及电商的支付到下单。
整体crud的设计图
包括了业务层和基础设施层的设计
当前文章的设计图如下
整体采用Mq异步的发布订阅，订阅之间也通过发布订阅通知，完成最终一致性
业务实体
public class BaseModel
{
[Key]
public int Id { get; set; }
public DateTime CreateTime { get; set; }
}
public class UserInfo: BaseModel
{ public string NickName { get; set; }
public decimal Money { get; set; }
public DateTime LastOptions { get; set; }
}
public class PayOrder: BaseModel
{
public int SourceId { get; set; }
public int TargetId { get; set; }
public decimal Money { get; set; }
}
配置EF Core
public class TransactionContexts:DbContext
{
public DbSet<PayOrder> PayOrders { get; set; }
public DbSet<UserInfo> UserInfos { get; set; } public TransactionContexts(DbContextOptions<TransactionContexts> options):base(options)
{ }
}
配置数据源偷懒就用InMemory了
services.AddDbContext<TransactionContexts>(build=> {
build.UseInMemoryDatabase("TransactionContexts");
});实例编写
建立一个交易的Command
internal class PayOrderCommand
{
public int SourceId { get; set; }
public int TargetId { get; set; }
public decimal Money { get; set; }
}
一个交易的Event
internal class PayOrderEvent: PayOrderCommand
{ }
Command对外，Event对内，主要是用于项目区分外部流程和内部流程的区别，代码本身是没有硬编码要求的
构建一个交易的服务，对外公开一个转账的接口
public interface ITransactionService
{
void TransferAccounts(int sourceId, int targetId, decimal money);
}
这个接口完成Publish/Subscribe模式的交易
Publish端
internal class TransactionService: ITransactionService
{
private IBusControl busControl; public TransactionService(IBusControl busControl)
{
this.busControl = busControl;
} public async void TransferAccounts(int sourceId, int targetId, decimal money)
{
await busControl.Publish(
new PayOrderCommand { SourceId = sourceId, TargetId = targetId, Money = money }
);
}
}
很常见的发布一个命令
Subscribe端
internal class TransactionConsumer :
IConsumer<PayOrderCommand>,
IConsumer<PayOrderEvent>
{
private TransactionContexts transactionContexts; public TransactionConsumer(TransactionContexts transactionContexts)
{
this.transactionContexts = transactionContexts;
} public async Task Consume(ConsumeContext<PayOrderCommand> context)
{
var value = context.Message; await Console.Out.WriteLineAsync($"PayOrderCommand Before:{DateTime.Now} SourceId:{value.SourceId} TargetId:{value.TargetId} Money:{value.Money}"); await transactionContexts.PayOrders.AddAsync(new PayOrder
{
Id = ,
SourceId = value.SourceId,
TargetId = value.TargetId,
Money = value.Money
});
await transactionContexts.SaveChangesAsync(); await context.Publish(new PayOrderEvent
{
SourceId = value.SourceId,
TargetId = value.TargetId,
Money = value.Money
}); await Console.Out.WriteLineAsync($"PayOrderCommand After:{DateTime.Now}");
} public async Task Consume(ConsumeContext<PayOrderEvent> context)
{
var value = context.Message; await Console.Out.WriteLineAsync($"PayOrderEvent Before:{DateTime.Now} SourceId:{value.SourceId} TargetId:{value.TargetId} Money:{value.Money}"); var source = transactionContexts.UserInfos.First(user => user.Id == value.SourceId); if (source.Money < value.Money)
throw new Exception(); var target = transactionContexts.UserInfos.First(user => user.Id == value.TargetId); source.Money -= value.Money;
target.Money += value.Money; transactionContexts.UserInfos.Update(source);
transactionContexts.UserInfos.Update(target); await transactionContexts.SaveChangesAsync(); await Console.Out.WriteLineAsync($"PayOrderEvent After:{DateTime.Now}");
}
}
配置依赖注入流程
MassTransit的通讯选择MassTransit.RabbitMQ，这个库，也支持很多MQ，个人图方便就选的rabbitmq，后期要更换，修改一下依赖注入的配置即可
services.AddScoped<TransactionConsumer>();
services.AddMassTransit(c =>
{
c.AddConsumer<TransactionConsumer>();
c.AddBus(serviceProvider =>
{
return Bus.Factory.CreateUsingRabbitMq(cfg =>
{
var host = cfg.Host(new Uri("rabbitmq://localhost/"), hst =>
{
hst.Username("guest");
hst.Password("guest");
});
cfg.ReceiveEndpoint("Transaction", config =>
{
config.ConfigureConsumer<TransactionConsumer>(serviceProvider);
});
});
});
});这样就完成了引入Masstransit做数据通讯部分，Masstransit支持Rpc模式，也支持Publish/Subscribe，后续的文章会混搭Rpc模式和发布订阅的模式，主要根据业务场景的选择做调整
编写演示例子
在Configure里面配置初始化数据
using (var serviceScoped = app.ApplicationServices.CreateScope())
{
var serviceProvider = serviceScoped.ServiceProvider;
var context = serviceProvider.GetRequiredService<TransactionContexts>(); context.UserInfos.Add(new UserInfo
{
Id = ,
NickName = "Form",
CreateTime = DateTime.Now,
LastOptions = DateTime.Now,
Money =
});
context.UserInfos.Add(new UserInfo
{
Id = ,
NickName = "To",
CreateTime = DateTime.Now,
LastOptions = DateTime.Now,
Money =
}); context.SaveChanges();
}
#endregion
给Configure方法增加一个注入的接口
public void Configure(IApplicationBuilder app, IHostingEnvironment env, IApplicationLifetime lifetime)
{
//。。。
var busControl = app.ApplicationServices.GetRequiredService<IBusControl>(); lifetime.ApplicationStarted.Register(busControl.Start);
lifetime.ApplicationStopped.Register(busControl.Stop);
}
依旧是省事儿的Configure方法里面写的一个管道
app.Run(async (context) =>
{
var serviceProvider = context.RequestServices; var bus = serviceProvider.GetRequiredService<IBusControl>(); await bus.Publish(new PayOrderCommand
{
SourceId = 1,
TargetId = 2,
Money = 2000
}); await context.Response.WriteAsync("Hello World!");
});
后话
写在默认的index管道，会触发一个有意思的BUG，会两次执行，但是主键是唯一的，这样重复执行会抛出异常，提示主键已存在
这个例子是先铺垫一下，很多有意思的实现还没开展
1、某个业务需要执行过程和下游强一致性，要么一起完成，要么当场失败
2、某个业务完成最终一致性，这个过程，如果失败需要重试/限流/熔断
3、某个业务完成最终一致性，失败了则触发补偿
先铺垫一下，后空余时间逐一编写示例演示
现在的代码一点都不优雅，还有很强的面向于具体实现的，后续会逐步高度抽象化，从相对麻烦的代码，变成纯crud拿来主义，业务层 和后续代码的流程无感
打个小广告
如果有技术交流可以加NCC的群 24791014、436035237，我在群里，有任何关于asp.net core/Masstransit的问题或者建议都可以与我交流，非常欢迎
示例代码: