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

52 lines
2.4 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;
namespace GFramework.Cqrs.Cqrs.Request;
/// <summary>
/// 抽象请求处理器基类,用于处理不返回具体响应的请求
/// 继承自轻量 CQRS 上下文基类并实现IRequestHandler接口
/// </summary>
/// <typeparam name="TRequest">请求类型必须实现IRequest[Unit]接口</typeparam>
public abstract class AbstractRequestHandler<TRequest> : CqrsContextAwareHandlerBase, IRequestHandler<TRequest, Unit>
where TRequest : IRequest<Unit>
{
/// <summary>
/// 处理请求的核心方法
/// </summary>
/// <param name="request">要处理的请求对象</param>
/// <param name="cancellationToken">取消令牌,用于取消操作</param>
/// <returns>表示异步操作的ValueTask完成时返回Unit值</returns>
public abstract ValueTask<Unit> Handle(TRequest request, CancellationToken cancellationToken);
}
/// <summary>
/// 抽象请求处理器基类,用于处理需要返回具体响应的请求
/// 继承自轻量 CQRS 上下文基类并实现IRequestHandler接口
/// </summary>
/// <typeparam name="TRequest">请求类型必须实现IRequest[TResponse]接口</typeparam>
/// <typeparam name="TResponse">响应类型</typeparam>
public abstract class AbstractRequestHandler<TRequest, TResponse> : CqrsContextAwareHandlerBase,
IRequestHandler<TRequest, TResponse> where TRequest : IRequest<TResponse>
{
/// <summary>
/// 处理请求并返回响应的核心方法
/// </summary>
/// <param name="request">要处理的请求对象</param>
/// <param name="cancellationToken">取消令牌,用于取消操作</param>
/// <returns>表示异步操作的ValueTask完成时返回处理结果</returns>
public abstract ValueTask<TResponse> Handle(TRequest request, CancellationToken cancellationToken);
}