GFramework/GFramework.Core/Cqrs/Command/AbstractCommandHandler.cs
GeWuYou 195c8321a1 feat(cqrs): 添加CQRS命令查询责任分离架构支持
- 实现抽象命令处理器基类支持命令处理
- 添加流式命令处理器基类支持异步流式响应
- 创建查询处理器基类提供统一查询处理接口
- 实现查询基类提供通用查询结构定义
- 扩展架构上下文接口集成CQRS运行时入口
- 定义消息处理器委托支持管道行为处理
- 实现CQRS处理器注册器扫描并注册处理器
- 添加架构模块行为测试验证模块安装功能
- 创建中介器高级特性测试覆盖边界场景
2026-04-14 21:37:32 +08:00

58 lines
2.8 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.Abstractions.Cqrs;
using GFramework.Core.Abstractions.Cqrs.Command;
using GFramework.Core.Rule;
namespace GFramework.Core.Cqrs.Command;
/// <summary>
/// 抽象命令处理器基类
/// 继承自 ContextAwareBase 并实现 IRequestHandler 接口,为具体的命令处理器提供基础功能。
/// 框架会在每次分发前注入当前架构上下文,因此派生类可以通过 Context 访问架构级服务。
/// </summary>
/// <typeparam name="TCommand">命令类型</typeparam>
public abstract class AbstractCommandHandler<TCommand> : ContextAwareBase, IRequestHandler<TCommand, Unit>
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 并实现 IRequestHandler 接口,为具体的命令处理器提供基础功能。
/// 支持泛型命令和结果类型,框架会在每次分发前注入当前架构上下文。
/// </summary>
/// <typeparam name="TCommand">命令类型必须实现ICommand接口</typeparam>
/// <typeparam name="TResult">命令执行结果类型</typeparam>
public abstract class AbstractCommandHandler<TCommand, TResult> : ContextAwareBase, IRequestHandler<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);
}