using GFramework.Core.Rule;
using GFramework.Cqrs.Abstractions.Cqrs.Command;

namespace GFramework.Core.Command;

/// <summary>
///     带返回值的抽象命令类，实现 ICommand{TResult} 接口，为需要返回结果的命令提供基础架构支持
/// </summary>
/// <typeparam name="TInput">命令输入参数类型，必须实现 ICommandInput 接口</typeparam>
/// <typeparam name="TResult">命令执行后返回的结果类型</typeparam>
/// <param name="input">命令执行所需的输入参数</param>
public abstract class AbstractCommand<TInput, TResult>(TInput input)
    : ContextAwareBase, Abstractions.Command.ICommand<TResult>
    where TInput : ICommandInput
{
    /// <summary>
    ///     执行命令的入口方法，实现 ICommand{TResult} 接口的 Execute 方法
    /// </summary>
    /// <returns>命令执行后的结果</returns>
    TResult Abstractions.Command.ICommand<TResult>.Execute()
    {
        return OnExecute(input);
    }

    /// <summary>
    ///     命令执行的抽象方法，由派生类实现具体的命令逻辑
    /// </summary>
    /// <param name="input">命令执行所需的输入参数</param>
    /// <returns>命令执行后的结果</returns>
    protected abstract TResult OnExecute(TInput input);
}
