mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-03-24 20:34:29 +08:00
91246ff482
- 新增 RunInBatch() 方法支持批处理通知折叠 - 添加 Undo()/Redo() 基于历史缓冲区的状态回退前进功能 - 实现 TimeTravelTo() 跳转到指定历史索引的能力 - 提供 ClearHistory() 以当前状态重置历史锚点的功能 - 支持可选历史缓冲区、撤销/重做和时间旅行功能 - 添加可选批处理通知折叠机制 - 实现多态 action 匹配（基类/接口）支持 - 在诊断信息中增加历史游标和批处理状态 - StoreBuilder 新增 WithHistoryCapacity() 和 WithActionMatching() 配置方法 - 优化 reducer 注册支持全局序号以实现稳定排序 - 实现多态匹配时的类型继承距离计算 - 添加批处理嵌套支持和状态通知延迟机制
66 lines
2.3 KiB
C#
66 lines
2.3 KiB
C#
namespace GFramework.Core.Abstractions.StateManagement;
|
||
|
||
/// <summary>
|
||
/// 暴露 Store 的诊断信息。
|
||
/// 该接口用于调试、监控和后续时间旅行能力的扩展，不参与状态写入流程。
|
||
/// </summary>
|
||
/// <typeparam name="TState">状态树的根状态类型。</typeparam>
|
||
public interface IStoreDiagnostics<TState>
|
||
{
|
||
/// <summary>
|
||
/// 获取当前已注册的订阅者数量。
|
||
/// </summary>
|
||
int SubscriberCount { get; }
|
||
|
||
/// <summary>
|
||
/// 获取最近一次分发的 action 类型。
|
||
/// 即使该次分发未引起状态变化，该值也会更新。
|
||
/// </summary>
|
||
Type? LastActionType { get; }
|
||
|
||
/// <summary>
|
||
/// 获取最近一次真正改变状态的时间戳。
|
||
/// 若尚未发生状态变化，则返回 <see langword="null"/>。
|
||
/// </summary>
|
||
DateTimeOffset? LastStateChangedAt { get; }
|
||
|
||
/// <summary>
|
||
/// 获取最近一次分发记录。
|
||
/// </summary>
|
||
StoreDispatchRecord<TState>? LastDispatchRecord { get; }
|
||
|
||
/// <summary>
|
||
/// 获取当前 Store 使用的 action 匹配策略。
|
||
/// </summary>
|
||
StoreActionMatchingMode ActionMatchingMode { get; }
|
||
|
||
/// <summary>
|
||
/// 获取历史缓冲区容量。
|
||
/// 返回 0 表示当前 Store 未启用历史记录能力。
|
||
/// </summary>
|
||
int HistoryCapacity { get; }
|
||
|
||
/// <summary>
|
||
/// 获取当前可见历史记录数量。
|
||
/// 当历史记录启用时，该值至少为 1，因为当前状态会作为历史锚点存在。
|
||
/// </summary>
|
||
int HistoryCount { get; }
|
||
|
||
/// <summary>
|
||
/// 获取当前状态在历史缓冲区中的索引。
|
||
/// 当未启用历史记录时返回 -1。
|
||
/// </summary>
|
||
int HistoryIndex { get; }
|
||
|
||
/// <summary>
|
||
/// 获取当前历史快照列表。
|
||
/// 调试工具可以基于该列表渲染时间旅行面板，而不需要访问 Store 内部结构。
|
||
/// </summary>
|
||
IReadOnlyList<StoreHistoryEntry<TState>> HistoryEntries { get; }
|
||
|
||
/// <summary>
|
||
/// 获取当前是否处于批处理阶段。
|
||
/// 该值为 <see langword="true"/> 时，状态变更通知会延迟到最外层批处理结束后再统一发送。
|
||
/// </summary>
|
||
bool IsBatching { get; }
|
||
} |