.netcore 分布式事务CAP2.6之控制台使用
- 2019 年 10 月 3 日
- 筆記
上一编讲了cap2.6的快速入门，这次我们来讲讲在控制台中如何使用cap2.6。因为cap2.6的内存模式目前已经可以使用了，相关组件已经更新，所以这次我们以简单的内存模式为例。
1：创建项目
创建一个名叫CAPConsoleDemo的 “控制台应用(.NET Core)” 程序，.netcore版本要求在2.2或以上。
2：添加相关引用
在nuget中添加 DotNetCore.CAP DotNetCore.CAP.InMemoryStorage Savorboard.CAP.InMemoryMessageQueue Microsoft.Extensions.Hosting 等组件的引用。
3：构建常规Host主机
常规host主机是.net core 2.1中引入的，本质是移除了web功能的webhost，以前webhost的所有依赖注入，生命周期管理，日志管理等都可以在控制台程序中使用。以后webhost都会是基于常规host来实现的。
实现方式也很简单，只要将Programe.cs中改成下面这样就好了
1 using Microsoft.Extensions.DependencyInjection; 2 using Microsoft.Extensions.Hosting; 3 using Savorboard.CAP.InMemoryMessageQueue; 4 using System; 5 6 namespace CAPConsoleDemo 7 { 8 class Program 9 { 10 static void Main(string[] args) 11 { 12 CreateHostBuilder(args).Build().Run(); //构建一个常规Host 13 } 14 static IHostBuilder CreateHostBuilder(string[] args) 15 { 16 var build = new HostBuilder(); 17 build.ConfigureServices((hostContext, services) => 18 { 19 services.AddCap(option => //添加CAP框架 20 { 21 option.UseInMemoryStorage(); //使用内存存储 22 option.UseInMemoryMessageQueue(); //使用内存队列 23 option.UseDashboard(); //添加监控仪表盘 24 }); 25 }); 26 return build; 27 } 28 } 29 }
4：添加推送程序
4.1： 添加一个继承自IHostedService的Publish类，并在里面创建一个定时器，每秒推送一次事件。
using DotNetCore.CAP; using Microsoft.Extensions.Hosting; using System; using System.Threading; using System.Threading.Tasks; namespace CAPConsoleDemo { public class Publish : IHostedService { private ICapPublisher capPublish; //CAP发布程序 private Timer _timer; //定时器 public Publish(ICapPublisher capPublish) //自动注入CAP程序 { this.capPublish = capPublish; } public Task StartAsync(CancellationToken cancellationToken) { _timer = new Timer(work, null, TimeSpan.Zero, TimeSpan.FromSeconds(1)); //每秒运行一次推送任务 return Task.CompletedTask; } private void work(object state) { capPublish.Publish<string>("Order.Created", DateTime.Now.ToString()); //推送Order.Created事件 Console.WriteLine("推送：" + DateTime.Now.ToString()); } public Task StopAsync(CancellationToken cancellationToken) { return Task.CompletedTask; } } }
4.2：在Programe.CreateHostBuilder方法中添加推送服务 services.AddHostedService<Publish>();
4.3：f5运行程序，此时是已经可以正常推送消息了。
5：添加监听服务
5.1：创建一个承继自ICapSubscribe接口的类Events，并监听Order.Created事件，代码如下：
1 using DotNetCore.CAP; 2 using System; 3 using System.Threading.Tasks; 4 5 namespace ConsoleApp2 6 { 7 public class Events : ICapSubscribe 8 { 9 10 11 [CapSubscribe("Order.Created")] //监听Order.Created事件 12 public async Task OrderCreatedEventHand(string msg) 13 { 14 Console.WriteLine("--接收："+ msg); 15 } 16 17 } 18 }
5.2： 在在Programe.CreateHostBuilder方法中添加监听服务 services.AddSingleton<ICapSubscribe, Events>();
6：大功造成
F5运行程序，可以看到程序在一边推送一边接收。
7：同一事件，多个服务监听处理。
默认情况下，一个事件只会被一个监听者处理，即使我们创建了多个服务来监听同一事件，也只会有一个服务收到此事件，其它服务是收不到的。那么怎么让多个服务同时处理同一事件呢？答案是使用分组，在添加监听器时使用不同的分组名称。
7.1：我们将Events类中的代码，稍微改动一下，使用两个都监听Order.Created事件的方法，但命名成不同的分组。
1 using DotNetCore.CAP; 2 using System; 3 using System.Threading.Tasks; 4 5 namespace CAPConsoleDemo 6 { 7 public class Events : ICapSubscribe 8 { 9 10 11 [CapSubscribe("Order.Created", Group = "Group1")] //监听Order.Created事件,并命名为Group1 12 public async Task OrderCreatedEventHand(string msg) 13 { 14 Console.WriteLine("--Group1接收：" + msg); 15 } 16 17 18 [CapSubscribe("Order.Created", Group = "Group2")] //监听Order.Created事件,并命名为Group2 19 public async Task Group2(string msg) 20 { 21 Console.WriteLine("--Group2接收：" + msg); 22 } 23 } 24 }
7.2：F5运行，如下图所示，一次推送事件，两个监听服务都处理了此事件。
示例代码下载：https://pan.baidu.com/s/1X2uCvcLjQ9AiqxMD3CtTcA
