mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-03-24 20:34:29 +08:00
2b4b87baba
- 实现 Store 类作为集中式状态容器，默认支持状态归约和订阅通知 - 添加 IReadonlyStore、IStore、IReducer 等状态管理相关抽象接口 - 实现 StoreExtensions 扩展方法，提供 Select 和 ToBindableProperty 选择器功能 - 添加 StoreSelection 类，支持从完整状态树中投影局部状态视图 - 实现 StoreDispatchContext 和 StoreDispatchRecord 用于分发过程诊断 - 添加 IStoreMiddleware 中间件接口，支持在分发过程中插入日志和审计逻辑 - 实现完整的状态选择器和绑定属性桥接功能，便于现有 UI 代码复用 - 添加 Store 相关单元测试，覆盖状态归约、订阅通知和选择器桥接场景
40 lines
1.7 KiB
C#
40 lines
1.7 KiB
C#
using GFramework.Core.Abstractions.Events;
|
|
|
|
namespace GFramework.Core.Abstractions.StateManagement;
|
|
|
|
/// <summary>
|
|
/// 只读状态容器接口，用于暴露应用状态快照和订阅能力。
|
|
/// 该抽象适用于 Controller、Query、ViewModel 等只需要观察状态的调用方，
|
|
/// 使其无需依赖写入能力即可响应复杂状态树的变化。
|
|
/// </summary>
|
|
/// <typeparam name="TState">状态树的根状态类型。</typeparam>
|
|
public interface IReadonlyStore<out TState>
|
|
{
|
|
/// <summary>
|
|
/// 获取当前状态快照。
|
|
/// Store 负责保证返回值与最近一次成功分发后的状态一致。
|
|
/// </summary>
|
|
TState State { get; }
|
|
|
|
/// <summary>
|
|
/// 订阅状态变化通知。
|
|
/// 仅当 Store 判断状态发生有效变化时，才会调用该监听器。
|
|
/// </summary>
|
|
/// <param name="listener">状态变化时的监听器，参数为新的状态快照。</param>
|
|
/// <returns>用于取消订阅的句柄。</returns>
|
|
IUnRegister Subscribe(Action<TState> listener);
|
|
|
|
/// <summary>
|
|
/// 订阅状态变化通知，并立即以当前状态调用一次监听器。
|
|
/// 该方法适合在 UI 初始化或 ViewModel 首次绑定时建立同步视图。
|
|
/// </summary>
|
|
/// <param name="listener">状态变化时的监听器，参数为新的状态快照。</param>
|
|
/// <returns>用于取消订阅的句柄。</returns>
|
|
IUnRegister SubscribeWithInitValue(Action<TState> listener);
|
|
|
|
/// <summary>
|
|
/// 取消订阅指定的状态监听器。
|
|
/// </summary>
|
|
/// <param name="listener">需要移除的监听器。</param>
|
|
void UnSubscribe(Action<TState> listener);
|
|
} |