mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-07 08:44:29 +08:00
295496e90f
- 添加完整的 CQRS 中文文档，涵盖命令、查询、处理器、管道行为等核心概念 - 实现 ArchitectureModules 类用于管理架构模块安装和 CQRS 行为注册 - 重构 Architecture 类为协调器模式，委托给专门的管理器组件 - 添加 RegisterCqrsPipelineBehavior 方法替代旧的 RegisterMediatorBehavior - 标记旧的扩展方法为 Obsolete 并提供新的兼容性别名 - 实现模块化架构组件注册和生命周期管理功能
49 lines
2.3 KiB
C#
49 lines
2.3 KiB
C#
using System.ComponentModel;
|
|
using GFramework.Core.Abstractions.Cqrs.Query;
|
|
using GFramework.Core.Abstractions.Rule;
|
|
using GFramework.Core.Cqrs.Extensions;
|
|
|
|
namespace GFramework.Core.Extensions;
|
|
|
|
/// <summary>
|
|
/// 提供对 <see cref="IContextAware" /> 接口的 CQRS 查询扩展方法。
|
|
/// 该类型保留旧名称以兼容历史调用点；新代码应改用 <see cref="GFramework.Core.Cqrs.Extensions.ContextAwareCqrsQueryExtensions" />。
|
|
/// 兼容层计划在未来的 major 版本中移除，因此不会继续承载新能力。
|
|
/// </summary>
|
|
[EditorBrowsable(EditorBrowsableState.Never)]
|
|
[Obsolete(
|
|
"Use GFramework.Core.Cqrs.Extensions.ContextAwareCqrsQueryExtensions instead. This compatibility alias will be removed in a future major version.")]
|
|
public static class ContextAwareMediatorQueryExtensions
|
|
{
|
|
/// <summary>
|
|
/// 发送查询的同步版本（不推荐,仅用于兼容性）
|
|
/// </summary>
|
|
/// <typeparam name="TResponse">查询响应类型</typeparam>
|
|
/// <param name="contextAware">实现 IContextAware 接口的对象</param>
|
|
/// <param name="query">要发送的查询对象</param>
|
|
/// <returns>查询结果</returns>
|
|
/// <exception cref="ArgumentNullException">当 contextAware 或 query 为 null 时抛出</exception>
|
|
public static TResponse SendQuery<TResponse>(this IContextAware contextAware, IQuery<TResponse> query)
|
|
{
|
|
return ContextAwareCqrsQueryExtensions.SendQuery(contextAware, query);
|
|
}
|
|
|
|
/// <summary>
|
|
/// 异步发送查询并返回结果
|
|
/// </summary>
|
|
/// <typeparam name="TResponse">查询响应类型</typeparam>
|
|
/// <param name="contextAware">实现 IContextAware 接口的对象</param>
|
|
/// <param name="query">要发送的查询对象</param>
|
|
/// <param name="cancellationToken">取消令牌,用于取消操作</param>
|
|
/// <returns>包含查询结果的ValueTask</returns>
|
|
/// <exception cref="ArgumentNullException">当 contextAware 或 query 为 null 时抛出</exception>
|
|
public static ValueTask<TResponse> SendQueryAsync<TResponse>(this IContextAware contextAware,
|
|
IQuery<TResponse> query, CancellationToken cancellationToken = default)
|
|
{
|
|
return ContextAwareCqrsQueryExtensions.SendQueryAsync(
|
|
contextAware,
|
|
query,
|
|
cancellationToken);
|
|
}
|
|
}
|