feat(state): 添加上下文感知状态基类

- 实现了ContextAwareStateBase类,继承IState和IContextAware接口
- 提供状态进入、退出和转换的基础功能
- 添加架构上下文的设置和获取方法
- 支持状态转换规则的自定义实现
- 包含完整的XML文档注释
This commit is contained in:
GeWuYou 2026-01-16 08:26:52 +08:00
parent c0274074b3
commit 941cbee0ad

View File

@ -0,0 +1,65 @@
using GFramework.Core.Abstractions.architecture;
using GFramework.Core.Abstractions.rule;
using GFramework.Core.Abstractions.state;
namespace GFramework.Core.state;
/// <summary>
/// 上下文感知状态基类
/// 提供基础的状态管理功能和架构上下文访问能力
/// 实现了IState和IContextAware接口
/// </summary>
public class ContextAwareStateBase : IState, IContextAware
{
/// <summary>
/// 架构上下文引用,用于访问架构相关的服务和数据
/// </summary>
private IArchitectureContext? _context;
/// <summary>
/// 设置架构上下文
/// </summary>
/// <param name="context">架构上下文实例</param>
public void SetContext(IArchitectureContext context)
{
_context = context;
}
/// <summary>
/// 获取架构上下文
/// </summary>
/// <returns>架构上下文实例</returns>
public IArchitectureContext GetContext()
{
return _context!;
}
/// <summary>
/// 进入状态时调用的方法
/// 子类可重写此方法以实现特定的状态进入逻辑
/// </summary>
/// <param name="fromState">从哪个状态转换而来可能为null表示初始状态</param>
public virtual void OnEnter(IState? fromState)
{
}
/// <summary>
/// 退出状态时调用的方法
/// 子类可重写此方法以实现特定的状态退出逻辑
/// </summary>
/// <param name="toState">将要转换到的目标状态可能为null表示结束状态</param>
public virtual void OnExit(IState? toState)
{
}
/// <summary>
/// 判断当前状态是否可以转换到目标状态
/// 子类可重写此方法以实现自定义的状态转换规则
/// </summary>
/// <param name="targetState">希望转换到的目标状态对象</param>
/// <returns>如果允许转换则返回true否则返回false</returns>
public virtual bool CanTransitionTo(IState targetState)
{
return true;
}
}