GFramework/GFramework.Cqrs.Benchmarks
gewuyou 017e689abd feat(cqrs): 补齐请求生命周期基准矩阵
- 新增 request handler Singleton 与 Transient 生命周期 benchmark,并说明 Scoped 对照的宿主前置条件

- 更新 benchmark README,补充当前覆盖范围与后续扩展方向

- 更新 cqrs-rewrite active tracking 与 trace,记录 RP-092 验证结果和沙箱外 benchmark 权威结论
2026-05-07 14:20:50 +08:00
..

GFramework.Cqrs.Benchmarks

该模块承载 GFramework.Cqrs 的独立性能基准工程,用于持续比较运行时 dispatch、publish、cold-start 与后续 generator / pipeline 收口的成本变化。

目的

  • GFramework.Cqrs 建立独立于 NUnit 集成测试的 BenchmarkDotNet 基线
  • 参考 ai-libs/Mediator/benchmarks 的场景组织方式,逐步补齐 request、notification、stream 与初始化成本对比
  • 为后续吸收 Mediator 的 dispatch 设计、fixture 组织和对比矩阵提供可重复验证入口

当前内容

  • Program.cs
    • benchmark 命令行入口
  • Messaging/Fixture.cs
    • 运行前输出并校验场景配置
  • Messaging/RequestBenchmarks.cs
    • direct handler、GFramework.Cqrs runtime 与 MediatR 的 request steady-state dispatch 对比
  • Messaging/RequestLifetimeBenchmarks.cs
    • Singleton / Transient 两类 handler 生命周期下direct handler、GFramework.Cqrs runtime 与 MediatR 的 request steady-state dispatch 对比
  • Messaging/RequestPipelineBenchmarks.cs
    • 0 / 1 / 4 个 pipeline 行为下direct handler、GFramework.Cqrs runtime 与 MediatR 的 request steady-state dispatch 对比
  • Messaging/RequestStartupBenchmarks.cs
    • InitializationColdStart 两组 request startup 成本对比,补齐与 Mediator comparison benchmark 更接近的 startup 维度
  • Messaging/RequestInvokerBenchmarks.cs
    • direct handler、GFramework.Cqrs reflection runtime、handwritten generated-invoker runtime 与 MediatR 的 request steady-state dispatch 对比
  • Messaging/StreamInvokerBenchmarks.cs
    • direct handler、GFramework.Cqrs reflection runtime、handwritten generated-invoker runtime 与 MediatR 的 stream 完整枚举对比
  • Messaging/NotificationBenchmarks.cs
    • GFramework.Cqrs runtime 与 MediatR 的单处理器 notification publish 对比
  • Messaging/StreamingBenchmarks.cs
    • direct handler、GFramework.Cqrs runtime 与 MediatR 的 stream request 完整枚举对比

最小使用方式

dotnet run --project GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release

也可以通过 BenchmarkDotNet 过滤器只运行某一类场景。

后续扩展方向

  • request / stream 的真实 source-generator 产物与 handwritten generated provider 对照
  • stream handler 生命周期矩阵
  • 带真实显式作用域边界的 scoped host 对照
  • generated invoker provider 与纯反射 dispatch / 建流对比继续扩展到更多场景