mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-07 00:39:00 +08:00
088f02d586
- 新增 CQRS 核心概念、命令查询处理器使用指南 - 添加管道行为、流式处理和最佳实践说明 - 实现 CQRS 协程扩展方法支持异步命令执行 - 添加 ContextAware 接口的 CQRS 命令查询扩展 - 集成 Microsoft DI 容器依赖注入支持 - 补充架构模块行为测试验证功能完整性 - 扩展 GameContext 测试用例提高代码覆盖率
51 lines
2.2 KiB
C#
51 lines
2.2 KiB
C#
using GFramework.Core.Abstractions.Cqrs.Query;
|
|
using GFramework.Core.Abstractions.Rule;
|
|
|
|
namespace GFramework.Core.Cqrs.Extensions;
|
|
|
|
/// <summary>
|
|
/// 提供对 <see cref="IContextAware" /> 接口的 CQRS 查询扩展方法。
|
|
/// </summary>
|
|
public static class ContextAwareCqrsQueryExtensions
|
|
{
|
|
/// <summary>
|
|
/// 发送查询的同步版本（不推荐，仅用于兼容同步调用链）。
|
|
/// </summary>
|
|
/// <typeparam name="TResponse">查询响应类型。</typeparam>
|
|
/// <param name="contextAware">实现 <see cref="IContextAware" /> 接口的对象。</param>
|
|
/// <param name="query">要发送的查询对象。</param>
|
|
/// <returns>查询结果。</returns>
|
|
/// <exception cref="ArgumentNullException">
|
|
/// 当 <paramref name="contextAware" /> 或 <paramref name="query" /> 为 <see langword="null" /> 时抛出。
|
|
/// </exception>
|
|
public static TResponse SendQuery<TResponse>(this IContextAware contextAware, IQuery<TResponse> query)
|
|
{
|
|
ArgumentNullException.ThrowIfNull(contextAware);
|
|
ArgumentNullException.ThrowIfNull(query);
|
|
|
|
return contextAware.GetContext().SendQuery(query);
|
|
}
|
|
|
|
/// <summary>
|
|
/// 异步发送查询并返回结果。
|
|
/// </summary>
|
|
/// <typeparam name="TResponse">查询响应类型。</typeparam>
|
|
/// <param name="contextAware">实现 <see cref="IContextAware" /> 接口的对象。</param>
|
|
/// <param name="query">要发送的查询对象。</param>
|
|
/// <param name="cancellationToken">取消令牌，用于取消操作。</param>
|
|
/// <returns>包含查询结果的 <see cref="ValueTask{TResult}" />。</returns>
|
|
/// <exception cref="ArgumentNullException">
|
|
/// 当 <paramref name="contextAware" /> 或 <paramref name="query" /> 为 <see langword="null" /> 时抛出。
|
|
/// </exception>
|
|
public static ValueTask<TResponse> SendQueryAsync<TResponse>(
|
|
this IContextAware contextAware,
|
|
IQuery<TResponse> query,
|
|
CancellationToken cancellationToken = default)
|
|
{
|
|
ArgumentNullException.ThrowIfNull(contextAware);
|
|
ArgumentNullException.ThrowIfNull(query);
|
|
|
|
return contextAware.GetContext().SendQueryAsync(query, cancellationToken);
|
|
}
|
|
}
|