mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-07 08:44:29 +08:00
5a2981a557
- 实现 CqrsCoroutineExtensions 扩展类，提供协程方式发送 CQRS 命令的功能 - 添加 SendCommandCoroutine 方法支持命令异步执行与异常处理 - 实现取消操作的特殊处理逻辑，区分取消、失败和成功状态 - 添加 ContextAwareCqrsCommandExtensions 扩展类，提供同步和异步命令发送方法 - 增加对 TaskCanceledException 的专门处理机制 - 完善相关单元测试，验证取消操作的异常处理行为
60 lines
2.7 KiB
C#
60 lines
2.7 KiB
C#
using GFramework.Core.Abstractions.Cqrs.Command;
|
|
using GFramework.Core.Abstractions.Rule;
|
|
|
|
namespace GFramework.Core.Cqrs.Extensions;
|
|
|
|
/// <summary>
|
|
/// 提供对 <see cref="IContextAware" /> 接口的 CQRS 命令扩展方法。
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// 该扩展类将命令分发统一路由到架构上下文中的 CQRS 运行时。
|
|
/// </remarks>
|
|
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>
|
|
/// <remarks>
|
|
/// 同步方法仅用于兼容同步调用链；新代码建议优先使用异步版本。
|
|
/// </remarks>
|
|
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>
|
|
/// <remarks>
|
|
/// 该方法直接返回底层 <see cref="ValueTask{TResult}" />，避免额外的 async 状态机分配。
|
|
/// </remarks>
|
|
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);
|
|
}
|
|
}
|