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 注册支持全局序号以实现稳定排序 - 实现多态匹配时的类型继承距离计算 - 添加批处理嵌套支持和状态通知延迟机制
62 lines
2.9 KiB
C#
62 lines
2.9 KiB
C#
namespace GFramework.Core.Abstractions.StateManagement;
|
|
|
|
/// <summary>
|
|
/// 定义 Store 构建器接口，用于在创建 Store 之前完成 reducer、中间件和比较器配置。
|
|
/// 该抽象适用于模块化注册、依赖注入装配和测试工厂，避免调用方必须依赖具体 Store 类型进行配置。
|
|
/// </summary>
|
|
/// <typeparam name="TState">状态树的根状态类型。</typeparam>
|
|
public interface IStoreBuilder<TState>
|
|
{
|
|
/// <summary>
|
|
/// 配置用于判断状态是否真正变化的比较器。
|
|
/// </summary>
|
|
/// <param name="comparer">状态比较器。</param>
|
|
/// <returns>当前构建器实例。</returns>
|
|
IStoreBuilder<TState> WithComparer(IEqualityComparer<TState> comparer);
|
|
|
|
/// <summary>
|
|
/// 配置历史缓冲区容量。
|
|
/// 传入 0 表示禁用历史记录；大于 0 时会保留最近若干个状态快照，用于撤销、重做和时间旅行调试。
|
|
/// </summary>
|
|
/// <param name="historyCapacity">历史缓冲区容量。</param>
|
|
/// <returns>当前构建器实例。</returns>
|
|
IStoreBuilder<TState> WithHistoryCapacity(int historyCapacity);
|
|
|
|
/// <summary>
|
|
/// 配置 reducer 的 action 匹配策略。
|
|
/// 默认使用 <see cref="StoreActionMatchingMode.ExactTypeOnly"/>，仅在需要复用基类或接口 action 层次时再启用多态匹配。
|
|
/// </summary>
|
|
/// <param name="actionMatchingMode">要使用的匹配策略。</param>
|
|
/// <returns>当前构建器实例。</returns>
|
|
IStoreBuilder<TState> WithActionMatching(StoreActionMatchingMode actionMatchingMode);
|
|
|
|
/// <summary>
|
|
/// 添加一个强类型 reducer。
|
|
/// </summary>
|
|
/// <typeparam name="TAction">当前 reducer 处理的 action 类型。</typeparam>
|
|
/// <param name="reducer">要添加的 reducer。</param>
|
|
/// <returns>当前构建器实例。</returns>
|
|
IStoreBuilder<TState> AddReducer<TAction>(IReducer<TState, TAction> reducer);
|
|
|
|
/// <summary>
|
|
/// 使用委托快速添加一个 reducer。
|
|
/// </summary>
|
|
/// <typeparam name="TAction">当前 reducer 处理的 action 类型。</typeparam>
|
|
/// <param name="reducer">执行归约的委托。</param>
|
|
/// <returns>当前构建器实例。</returns>
|
|
IStoreBuilder<TState> AddReducer<TAction>(Func<TState, TAction, TState> reducer);
|
|
|
|
/// <summary>
|
|
/// 添加一个 Store 中间件。
|
|
/// </summary>
|
|
/// <param name="middleware">要添加的中间件。</param>
|
|
/// <returns>当前构建器实例。</returns>
|
|
IStoreBuilder<TState> UseMiddleware(IStoreMiddleware<TState> middleware);
|
|
|
|
/// <summary>
|
|
/// 基于给定初始状态创建一个新的 Store。
|
|
/// </summary>
|
|
/// <param name="initialState">Store 的初始状态。</param>
|
|
/// <returns>已应用当前构建器配置的 Store 实例。</returns>
|
|
IStore<TState> Build(TState initialState);
|
|
} |