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消息订阅器

1. 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的子类）

​