3.Ray-Event编写

Event作用：

• 存储事件数据。

1. IEventBase
   K：是Actor的StateId的类型，可以是long、可以是string，Ray一般使用OGuid生成的字符串作为主键。

2. 编写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。
   

3. 特性说明
   • ProtoContract：Ray默认使用ProtoBuf对Event序列化。
   • Immutable：Actor之间使用的时候。
   • Obsolete：事件过期时标记。
4. 无参构造函数
   • 作用：反序列化时用。
   • 备注：必须写。
5. 自定义属性与有参构造函数
   • 自定义属性：Event中用到的参数。
   • 有参构造函数：用于自定义属性的初始化。
6. 事件过期
   • 弃用事件标记为Obsolete。
   • 新事件在业务逻辑上做兼容性处理。

---

API：该部分只介绍使用，高级部分在后面文档说明。

​