From 9a783f3caa7586c018572b45f1c25d2edd3346c3 Mon Sep 17 00:00:00 2001
From: GeWuYou <95328647+GeWuYou@users.noreply.github.com>
Date: Sat, 14 Feb 2026 13:39:01 +0800
Subject: [PATCH] =?UTF-8?q?feat(cqrs):=20=E6=B7=BB=E5=8A=A0=E6=B5=81?=
 =?UTF-8?q?=E5=BC=8F=E5=91=BD=E4=BB=A4=E3=80=81=E6=9F=A5=E8=AF=A2=E5=92=8C?=
 =?UTF-8?q?=E8=AF=B7=E6=B1=82=E5=A4=84=E7=90=86=E5=99=A8=E5=9F=BA=E7=B1=BB?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 新增 AbstractStreamCommandHandler 基类支持流式命令处理
- 新增 AbstractStreamQueryHandler 基类支持流式查询处理
- 新增 AbstractStreamRequestHandler 基类支持流式请求处理
- 所有基类继承 ContextAwareBase 并实现对应的流式处理器接口
- 提供统一的异步可枚举响应序列处理机制
- 支持取消令牌用于控制流式操作的执行过程
---
 .../command/AbstractStreamCommandHandler.cs   | 38 +++++++++++++++++++
 .../cqrs/query/AbstractStreamQueryHandler.cs  | 38 +++++++++++++++++++
 .../request/AbstractStreamRequestHandler.cs   | 38 +++++++++++++++++++
 3 files changed, 114 insertions(+)
 create mode 100644 GFramework.Core/cqrs/command/AbstractStreamCommandHandler.cs
 create mode 100644 GFramework.Core/cqrs/query/AbstractStreamQueryHandler.cs
 create mode 100644 GFramework.Core/cqrs/request/AbstractStreamRequestHandler.cs

diff --git a/GFramework.Core/cqrs/command/AbstractStreamCommandHandler.cs b/GFramework.Core/cqrs/command/AbstractStreamCommandHandler.cs
new file mode 100644
index 0000000..c5f3f04
--- /dev/null
+++ b/GFramework.Core/cqrs/command/AbstractStreamCommandHandler.cs
@@ -0,0 +1,38 @@
+// Copyright (c) 2026 GeWuYou
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// 
+//     http://www.apache.org/licenses/LICENSE-2.0
+// 
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+using GFramework.Core.rule;
+using Mediator;
+
+namespace GFramework.Core.cqrs.command;
+
+/// <summary>
+/// 抽象流式命令处理器基类
+/// 继承自ContextAwareBase并实现IStreamCommandHandler接口，为具体的流式命令处理器提供基础功能
+/// 支持流式处理命令并产生异步可枚举的响应序列
+/// </summary>
+/// <typeparam name="TCommand">流式命令类型，必须实现IStreamCommand接口</typeparam>
+/// <typeparam name="TResponse">流式命令响应元素类型</typeparam>
+public abstract class AbstractStreamCommandHandler<TCommand, TResponse> : ContextAwareBase,
+    IStreamCommandHandler<TCommand, TResponse>
+    where TCommand : IStreamCommand<TResponse>
+{
+    /// <summary>
+    /// 处理流式命令并返回异步可枚举的响应序列
+    /// 由具体的流式命令处理器子类实现流式处理逻辑
+    /// </summary>
+    /// <param name="command">要处理的流式命令对象</param>
+    /// <param name="cancellationToken">取消令牌，用于取消流式处理操作</param>
+    /// <returns>异步可枚举的响应序列，每个元素类型为TResponse</returns>
+    public abstract IAsyncEnumerable<TResponse> Handle(TCommand command, CancellationToken cancellationToken);
+}
\ No newline at end of file
diff --git a/GFramework.Core/cqrs/query/AbstractStreamQueryHandler.cs b/GFramework.Core/cqrs/query/AbstractStreamQueryHandler.cs
new file mode 100644
index 0000000..a7c4eb0
--- /dev/null
+++ b/GFramework.Core/cqrs/query/AbstractStreamQueryHandler.cs
@@ -0,0 +1,38 @@
+// Copyright (c) 2026 GeWuYou
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// 
+//     http://www.apache.org/licenses/LICENSE-2.0
+// 
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+using GFramework.Core.rule;
+using Mediator;
+
+namespace GFramework.Core.cqrs.query;
+
+/// <summary>
+/// 抽象流式查询处理器基类
+/// 继承自ContextAwareBase并实现IStreamQueryHandler接口，为具体的流式查询处理器提供基础功能
+/// 支持流式处理查询并产生异步可枚举的响应序列，适用于大数据量或实时数据查询场景
+/// </summary>
+/// <typeparam name="TQuery">流式查询类型，必须实现IStreamQuery接口</typeparam>
+/// <typeparam name="TResponse">流式查询响应元素类型</typeparam>
+public abstract class AbstractStreamQueryHandler<TQuery, TResponse> : ContextAwareBase,
+    IStreamQueryHandler<TQuery, TResponse>
+    where TQuery : IStreamQuery<TResponse>
+{
+    /// <summary>
+    /// 处理流式查询并返回异步可枚举的响应序列
+    /// 由具体的流式查询处理器子类实现流式查询处理逻辑
+    /// </summary>
+    /// <param name="query">要处理的流式查询对象</param>
+    /// <param name="cancellationToken">取消令牌，用于取消流式查询操作</param>
+    /// <returns>异步可枚举的响应序列，每个元素类型为TResponse</returns>
+    public abstract IAsyncEnumerable<TResponse> Handle(TQuery query, CancellationToken cancellationToken);
+}
\ No newline at end of file
diff --git a/GFramework.Core/cqrs/request/AbstractStreamRequestHandler.cs b/GFramework.Core/cqrs/request/AbstractStreamRequestHandler.cs
new file mode 100644
index 0000000..a6cdd31
--- /dev/null
+++ b/GFramework.Core/cqrs/request/AbstractStreamRequestHandler.cs
@@ -0,0 +1,38 @@
+// Copyright (c) 2026 GeWuYou
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// 
+//     http://www.apache.org/licenses/LICENSE-2.0
+// 
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+using GFramework.Core.rule;
+using Mediator;
+
+namespace GFramework.Core.cqrs.request;
+
+/// <summary>
+/// 抽象流式请求处理器基类
+/// 继承自ContextAwareBase并实现IStreamRequestHandler接口，为具体的流式请求处理器提供基础功能
+/// 支持流式处理请求并产生异步可枚举的响应序列，适用于需要逐步返回结果的请求处理场景
+/// </summary>
+/// <typeparam name="TRequest">流式请求类型，必须实现IStreamRequest接口</typeparam>
+/// <typeparam name="TResponse">流式请求响应元素类型</typeparam>
+public abstract class AbstractStreamRequestHandler<TRequest, TResponse> : ContextAwareBase,
+    IStreamRequestHandler<TRequest, TResponse>
+    where TRequest : IStreamRequest<TResponse>
+{
+    /// <summary>
+    /// 处理流式请求并返回异步可枚举的响应序列
+    /// 由具体的流式请求处理器子类实现流式请求处理逻辑
+    /// </summary>
+    /// <param name="request">要处理的流式请求对象</param>
+    /// <param name="cancellationToken">取消令牌，用于取消流式请求操作</param>
+    /// <returns>异步可枚举的响应序列，每个元素类型为TResponse</returns>
+    public abstract IAsyncEnumerable<TResponse> Handle(TRequest request, CancellationToken cancellationToken);
+}
\ No newline at end of file