GFramework/GFramework.Cqrs/Cqrs/Query/AbstractQueryHandler.cs
GeWuYou e36c80229a feat(cqrs): 添加CQRS处理器基类和测试运行时支持
- 引入AbstractCommandHandler、AbstractQueryHandler等各类处理器基类
- 实现CqrsContextAwareHandlerBase提供上下文感知功能
- 添加CqrsTestRuntime为测试项目提供CQRS运行时访问入口
- 创建AbstractCqrsHandlerContextTests验证上下文注入行为
- 支持命令、查询、通知及流式处理的各种抽象基类实现
2026-04-15 20:34:08 +08:00

39 lines
1.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.Cqrs.Abstractions.Cqrs;
using GFramework.Cqrs.Abstractions.Cqrs.Query;
namespace GFramework.Cqrs.Cqrs.Query;
/// <summary>
/// 抽象查询处理器基类
/// 继承自轻量 CQRS 上下文基类并实现 IRequestHandler 接口,为具体的查询处理器提供基础功能。
/// 框架会在每次分发前注入当前架构上下文,因此派生类可以通过 Context 访问架构级服务。
/// </summary>
/// <typeparam name="TQuery">查询类型必须实现IQuery接口</typeparam>
/// <typeparam name="TResult">查询结果类型</typeparam>
public abstract class AbstractQueryHandler<TQuery, TResult> : CqrsContextAwareHandlerBase,
IRequestHandler<TQuery, TResult>
where TQuery : IQuery<TResult>
{
/// <summary>
/// 处理指定的查询并返回结果
/// 由具体的查询处理器子类实现查询处理逻辑
/// </summary>
/// <param name="query">要处理的查询对象</param>
/// <param name="cancellationToken">取消令牌,用于取消操作</param>
/// <returns>表示异步操作完成的ValueTask包含查询结果</returns>
public abstract ValueTask<TResult> Handle(TQuery query, CancellationToken cancellationToken);
}