GFramework/GFramework.Core/Cqrs/Command/AbstractCommandHandler.cs
GeWuYou cb0d0682b0 refactor(core): 统一C#命名规范并添加校验脚本
- 将所有IoC相关命名空间从"IoC"重命名为"Ioc"
- 将所有CQRS相关命名空间从"CQRS"重命名为"Cqrs"
- 更新所有受影响的using语句以匹配新的命名空间
- 在CI工作流中添加C#命名规范校验步骤
- 修正了测试文件中的命名空间引用
2026-03-13 09:41:43 +08:00

55 lines
2.5 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

// Copyright (c) 2026 GeWuYou
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
using GFramework.Core.Rule;
using Mediator;
namespace GFramework.Core.Cqrs.Command;
/// <summary>
/// 抽象命令处理器基类
/// 继承自ContextAwareBase并实现ICommandHandler接口为具体的命令处理器提供基础功能
/// </summary>
/// <typeparam name="TCommand">命令类型</typeparam>
public abstract class AbstractCommandHandler<TCommand> : ContextAwareBase, ICommandHandler<TCommand>
where TCommand : ICommand<Unit>
{
/// <summary>
/// 处理指定的命令
/// 由具体的命令处理器子类实现命令处理逻辑
/// </summary>
/// <param name="command">要处理的命令对象</param>
/// <param name="cancellationToken">取消令牌,用于取消操作</param>
/// <returns>表示异步操作完成的ValueTask返回Unit类型表示无返回值</returns>
public abstract ValueTask<Unit> Handle(TCommand command, CancellationToken cancellationToken);
}
/// <summary>
/// 抽象命令处理器基类(带返回值版本)
/// 继承自ContextAwareBase并实现ICommandHandler接口为具体的命令处理器提供基础功能
/// 支持泛型命令和结果类型实现CQRS模式中的命令处理
/// </summary>
/// <typeparam name="TCommand">命令类型必须实现ICommand接口</typeparam>
/// <typeparam name="TResult">命令执行结果类型</typeparam>
public abstract class AbstractCommandHandler<TCommand, TResult> : ContextAwareBase, ICommandHandler<TCommand, TResult>
where TCommand : ICommand<TResult>
{
/// <summary>
/// 处理指定的命令并返回结果
/// 由具体的命令处理器子类实现命令处理逻辑
/// </summary>
/// <param name="command">要处理的命令对象</param>
/// <param name="cancellationToken">取消令牌,用于取消操作</param>
/// <returns>表示异步操作完成的ValueTask包含命令执行结果</returns>
public abstract ValueTask<TResult> Handle(TCommand command, CancellationToken cancellationToken);
}