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.3 KiB
C#
51 lines
2.3 KiB
C#
using GFramework.Core.Abstractions.Cqrs.Command;
|
|
using GFramework.Core.Abstractions.Rule;
|
|
|
|
namespace GFramework.Core.Cqrs.Extensions;
|
|
|
|
/// <summary>
|
|
/// 提供对 <see cref="IContextAware" /> 接口的 CQRS 命令扩展方法。
|
|
/// </summary>
|
|
public static class ContextAwareCqrsCommandExtensions
|
|
{
|
|
/// <summary>
|
|
/// 发送命令的同步版本（不推荐，仅用于兼容同步调用链）。
|
|
/// </summary>
|
|
/// <typeparam name="TResponse">命令响应类型。</typeparam>
|
|
/// <param name="contextAware">实现 <see cref="IContextAware" /> 接口的对象。</param>
|
|
/// <param name="command">要发送的命令对象。</param>
|
|
/// <returns>命令执行结果。</returns>
|
|
/// <exception cref="ArgumentNullException">
|
|
/// 当 <paramref name="contextAware" /> 或 <paramref name="command" /> 为 <see langword="null" /> 时抛出。
|
|
/// </exception>
|
|
public static TResponse SendCommand<TResponse>(this IContextAware contextAware, ICommand<TResponse> command)
|
|
{
|
|
ArgumentNullException.ThrowIfNull(contextAware);
|
|
ArgumentNullException.ThrowIfNull(command);
|
|
|
|
return contextAware.GetContext().SendCommand(command);
|
|
}
|
|
|
|
/// <summary>
|
|
/// 异步发送命令并返回结果。
|
|
/// </summary>
|
|
/// <typeparam name="TResponse">命令响应类型。</typeparam>
|
|
/// <param name="contextAware">实现 <see cref="IContextAware" /> 接口的对象。</param>
|
|
/// <param name="command">要发送的命令对象。</param>
|
|
/// <param name="cancellationToken">取消令牌，用于取消操作。</param>
|
|
/// <returns>包含命令执行结果的 <see cref="ValueTask{TResult}" />。</returns>
|
|
/// <exception cref="ArgumentNullException">
|
|
/// 当 <paramref name="contextAware" /> 或 <paramref name="command" /> 为 <see langword="null" /> 时抛出。
|
|
/// </exception>
|
|
public static ValueTask<TResponse> SendCommandAsync<TResponse>(
|
|
this IContextAware contextAware,
|
|
ICommand<TResponse> command,
|
|
CancellationToken cancellationToken = default)
|
|
{
|
|
ArgumentNullException.ThrowIfNull(contextAware);
|
|
ArgumentNullException.ThrowIfNull(command);
|
|
|
|
return contextAware.GetContext().SendCommandAsync(command, cancellationToken);
|
|
}
|
|
}
|