Event作用:
- 存储事件数据。
IEventBase
K:是Actor的StateId的类型,可以是long、可以是string,Ray一般使用OGuid生成的字符串作为主键。-
编写Event继承IEventBase接口,Base部分如下:
public string Id { get; set; }
public uint Version { get; set; }
public string CommandId { get; set; }
public DateTime Timestamp { get; set; }
public string StateId { get; set; }
public string TypeCode => this.GetType().FullName;Id:
- 含义:当前Event的Id。
- 作用:标识当前Event。
- 备注:不赋值时,Ray会自动赋值。 Version:
- 含义:Event的版本戳。
- 作用:防止事件乱序。
- 备注:Ray会自动赋值。 CommandId:
- 含义:当前Event的CommandId。
- 作用:一个请求(Command)可能会引发多个Event,多个Event之间拥有相同的CommandId,多个Event通过CommandId建立联系。
- 备注:不需要时默认为null。 Timestamp:
- 含义:当前Event的时间戳。
- 作用:记录当前Event的发生时间,时间为UTC时间。
- 备注:不赋值时,Ray会自动赋值。 StateId:
- 含义:Actor的Id。
- 作用:记录引发事件的Actor的Id。
- 备注:Ray会自动赋值。 TypeCode:
- 含义:事件的类型。
- 作用:事件存储时会存储为二进制,重放时用于反序列化为对应的类型。
- 备注:public string TypeCode => this.GetType().FullName。 - 特性说明
- ProtoContract:Ray默认使用ProtoBuf对Event序列化。
- Immutable:Actor之间使用的时候。
- Obsolete:事件过期时标记。
- 无参构造函数
- 作用:反序列化时用。
- 备注:必须写。
- 自定义属性与有参构造函数
- 自定义属性:Event中用到的参数。
- 有参构造函数:用于自定义属性的初始化。
- 事件过期
- 弃用事件标记为Obsolete。
- 新事件在业务逻辑上做兼容性处理。
API:该部分只介绍使用,高级部分在后面文档说明。