6.Ray-消息订阅器编写
消息订阅器:
Ray是基于Event Sourcing设计的ES/Actor框架,消息发布后需要订阅处理,订阅器主要有以下两类:
- CoreHandler消息订阅器=RabbitSub+SubHandler
- ToReadHandler消息订阅器=RabbitSub+SQLToReadHandler(ToReadHandler的子类)
RabbitSub特性
RabbitSub特性是RabbitMQ消息队列订阅器。
RabbitSub特性有两个构造函数,常用的是这个:
public RabbitSubAttribute(string group, string exchange, string queue, int queueCount = 1)
- group:通常用于分类。示例中,X-CoreHandler的group是Core,X-ToReadHandler是Read。
- exchange:RabbitMQ中的exchange名称。
- queue:RabbitMQ中的queue名称。
- queueCount:消息队列数。用于消息的负载均衡。
示例:
[RabbitSub("Core", "Account", "account")]
public sealed class AccountCoreHandler : SubHandler<string, MessageInfo>
{
……
}
RabbitSub可以单独使用,用于订阅消息。
CoreHandler消息订阅器
Ray中的ESActor通过RaiseEvent方法发布事件,传递消息。Ray默认使用RabbitMQ传递消息。ESActor发起事件后,CoreHandler订阅事件,以处理事件。
实现方式是:
- 继承SubHandler。
- 添加RabbitSub特性。 exchange名称、queue名称与ESGrain上RabbitPub特性的标识一致。
- 添加构造函数(必须)。
public AccountCoreHandler(IServiceProvider svProvider) : base(svProvider) { }
- 事件被订阅后会流转到Tell方法中,data是要处理的事件。
public override Task Tell(byte[] bytes, IActorOwnMessage<string> data, MessageInfo msg) { switch (data) { case AmountTransferEvent value: return Task.WhenAll(task, AmountAddEventHandler(value)); default: return task; } }
ToReadHandler消息订阅器
- SQLToReadHandler
ESActor发起事件后,X-ToReadHandler订阅事件,以处理事件。X-ToReadHandler继承自X-SQLToReadHandler,X-SQLToReadHandler继承自ToReadHandler。
示例图:
X-SQLToReadHandler需要使用者继承PartSubHandler,根据使用的关系型数据库自己实现。Ray默认提供了PostgreSQL的PSQLToReadHandler。如果使用的是MySQL、SQL Server等其他关系型数据库,请自定义实现。
X-SQLToReadHandler实现细节:
修改对应关系型数据库的Integrity Constraint Violation(违反完整性约束)
的异常。
可以将实例中PSQLToReadHandler当做X-ToReadHandler模板,修改if (!(t.Exception.InnerException is Npgsql.PostgresException e && e.SqlState == "23505"))
即可。
说明:
当X-ToReadHandler订阅消息,消息有重放的场景,如果该消息已经得到处理,数据库中已经存在其处理后的结果,这是可能会报Integrity Constraint Violation(违反完整性约束)
异常,默认不做处理,其他异常将其抛出,这是这段代码的作用。
示例模板:
public abstract class PSQLToReadHandler<K> : PartSubHandler<K, MessageInfo>
{
public PSQLToReadHandler(IServiceProvider svProvider) : base(svProvider)
{ }
public override Task Notice(byte[] data)
{
return base.Notice(data).ContinueWith(t =>
{
if (t.Exception != null)
{
//根据使用数据库,修改这个if判断
if (!(t.Exception.InnerException is Npgsql.PostgresException e && e.SqlState == "23505"))
{
throw t.Exception;
}
}
});
}
}
2. X-ToReadHandler
X-ToReadHandler订阅器主要用于订阅感兴趣的消息,将数据写入到数据库中。
实现方式是:
- 实现SQLToReadHandler
- ToReadHandler继承SQLToReadHandler(ToReadHandler的子类)
- 添加RabbitSub特性。
- 添加构造函数(必须),在构造函数中注册关注的事件。
代码如下所示:public AccountToReadHandler(IServiceProvider svProvider) : base(svProvider) { Register<AmountAddEvent>(); Register<AmountTransferEvent>(); }
[RabbitSub("Read", "Account", "account")]
public sealed class AccountToReadHandler : PSQLToReadHandler<string>
{
public AccountToReadHandler(IServiceProvider svProvider) : base(svProvider)
{
Register<AmountAddEvent>();
Register<AmountTransferEvent>();
}
}
X-ToReadHandler消息订阅器与CoreHandler消息订阅器差异
X-ToReadHandler消息订阅器使用时,需要在构造函数中注册关心的事件,而X-CoreHandler中不需要,原因是事件在处理中需要反序列化,X-CoreHandler会对RabbitSub参数指定订阅的所有的消息反序列化,X-ToReadHandler在此基础上做了进一步的控制,在订阅的消息中只对Register的事件处理。这样做的原因:1.反序列化会消耗一定的性能,进一步控制有助于提高性能;2.Ray提供两种实现方式,为开发者扩展自定义源码提供借鉴。
总结:
- CoreHandler消息订阅器=RabbitSub+SubHandler
- ToReadHandler消息订阅器=RabbitSub+SQLToReadHandler(ToReadHandler的子类)