mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-07 00:39:00 +08:00
a80ff59631
- 新增ContextAwareMediatorCommandExtensions提供命令扩展方法的兼容性别名 - 新增ContextAwareMediatorExtensions提供CQRS统一接口扩展方法的兼容性别名 - 新增ContextAwareMediatorQueryExtensions提供查询扩展方法的兼容性别名 - 添加CqrsRuntimeModule用于注册CQRS运行时和处理器注册器到依赖注入容器 - 更新IArchitectureContext接口添加新版CQRS请求、命令、查询和通知的统一入口 - 添加架构上下文的CQRS处理器注册相关单元测试 - 配置项目文件以支持多目标框架和包引用管理
60 lines
2.6 KiB
C#
60 lines
2.6 KiB
C#
using GFramework.Core.Abstractions.Rule;
|
|
using GFramework.Cqrs.Abstractions.Cqrs.Command;
|
|
|
|
namespace GFramework.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);
|
|
}
|
|
}
|