GFramework/GFramework.Core/command/AbstractCommand.cs
GwWuYou 82713e34f0 refactor(core): 重构架构和命令相关代码结构
- 调整了 Architecture 类中字段和方法的布局,提升可读性
- 优化了命令执行逻辑,明确区分有无返回值的命令处理
- 规范了接口和抽象类的注释格式,增强文档清晰度
- 统一了代码风格,对齐缩进与换行符使用
- 补充了事件系统中泛型事件类的功能实现
- 完善了 README 文档中的条目结构和内容表述
2025-12-12 21:10:21 +08:00

85 lines
2.5 KiB
C#

using GFramework.Core.architecture;
using GFramework.Core.rule;
namespace GFramework.Core.command;
/// <summary>
/// 抽象命令类,实现 ICommand 接口,为具体命令提供基础架构支持
/// </summary>
public abstract class AbstractCommand : ICommand
{
private IArchitecture _mArchitecture;
/// <summary>
/// 获取命令所属的架构实例
/// </summary>
/// <returns>IArchitecture 架构接口实例</returns>
IArchitecture IBelongToArchitecture.GetArchitecture()
{
return _mArchitecture;
}
/// <summary>
/// 设置命令所属的架构实例
/// </summary>
/// <param name="architecture">要设置的架构实例</param>
void ICanSetArchitecture.SetArchitecture(IArchitecture architecture)
{
_mArchitecture = architecture;
}
/// <summary>
/// 执行命令,调用抽象方法 OnExecute 来实现具体逻辑
/// </summary>
void ICommand.Execute()
{
OnExecute();
}
/// <summary>
/// 抽象方法,由子类实现具体的命令执行逻辑
/// </summary>
protected abstract void OnExecute();
}
/// <summary>
/// 带返回值的抽象命令类,实现 ICommand{TResult} 接口,为需要返回结果的命令提供基础架构支持
/// </summary>
/// <typeparam name="TResult">命令执行后返回的结果类型</typeparam>
public abstract class AbstractCommand<TResult> : ICommand<TResult>
{
private IArchitecture _mArchitecture;
/// <summary>
/// 获取命令所属的架构实例
/// </summary>
/// <returns>IArchitecture 架构接口实例</returns>
IArchitecture IBelongToArchitecture.GetArchitecture()
{
return _mArchitecture;
}
/// <summary>
/// 设置命令所属的架构实例
/// </summary>
/// <param name="architecture">要设置的架构实例</param>
void ICanSetArchitecture.SetArchitecture(IArchitecture architecture)
{
_mArchitecture = architecture;
}
/// <summary>
/// 执行命令,调用抽象方法 OnExecute 来实现具体逻辑并返回结果
/// </summary>
/// <returns>TResult 类型的执行结果</returns>
TResult ICommand<TResult>.Execute()
{
return OnExecute();
}
/// <summary>
/// 抽象方法,由子类实现具体的命令执行逻辑
/// </summary>
/// <returns>TResult 类型的执行结果</returns>
protected abstract TResult OnExecute();
}