// Copyright (c) 2025-2026 GeWuYou // SPDX-License-Identifier: Apache-2.0 using BenchmarkDotNet.Attributes; using BenchmarkDotNet.Columns; using BenchmarkDotNet.Configs; using BenchmarkDotNet.Diagnosers; using BenchmarkDotNet.Jobs; using BenchmarkDotNet.Order; using System; using System.Threading; using System.Threading.Tasks; using GFramework.Core.Abstractions.Logging; using GFramework.Core.Ioc; using GFramework.Core.Logging; using GFramework.Cqrs.Abstractions.Cqrs; using MediatR; using Microsoft.Extensions.DependencyInjection; using ILogger = GFramework.Core.Abstractions.Logging.ILogger; namespace GFramework.Cqrs.Benchmarks.Messaging; /// /// 对比 request 宿主的初始化与首次分发成本,作为后续吸收 `Mediator` comparison benchmark 设计的 startup 基线。 /// [Config(typeof(Config))] public class RequestStartupBenchmarks { private static readonly ILogger RuntimeLogger = CreateLogger(nameof(RequestStartupBenchmarks)); private static readonly BenchmarkRequest Request = new(Guid.NewGuid()); private ServiceProvider _serviceProvider = null!; private IMediator _mediatr = null!; private ICqrsRuntime _runtime = null!; /// /// 配置 request startup benchmark 的公共输出格式。 /// private sealed class Config : ManualConfig { public Config() { AddJob(Job.Default .WithId("ColdStart") .WithInvocationCount(1) .WithUnrollFactor(1)); AddColumnProvider(DefaultColumnProviders.Instance); AddColumn(new CustomColumn("Scenario", static (_, _) => "RequestStartup"), TargetMethodColumn.Method, CategoriesColumn.Default); AddDiagnoser(MemoryDiagnoser.Default); AddLogicalGroupRules(BenchmarkLogicalGroupRule.ByCategory); WithOrderer(new DefaultOrderer(SummaryOrderPolicy.FastestToSlowest, MethodOrderPolicy.Declared)); } } /// /// 构建 steady-state 初始化 benchmark 复用的宿主对象。 /// [GlobalSetup] public void Setup() { Fixture.Setup("RequestStartup", handlerCount: 1, pipelineCount: 0); _serviceProvider = CreateMediatRServiceProvider(); _mediatr = _serviceProvider.GetRequiredService(); _runtime = CreateGFrameworkRuntime(); } /// /// 在每次 cold-start 迭代前清空 dispatcher 静态缓存,确保两组 benchmark 都重新命中首次绑定路径。 /// /// /// 使用 `IterationSetup` 而不是把缓存清理写在 benchmark 方法主体中, /// 可以把“清理静态缓存”留在测量边界之外,只保留宿主构建与首次发送本身。 /// [IterationSetup] public void ResetColdStartCaches() { BenchmarkDispatcherCacheHelper.ClearDispatcherCaches(); } /// /// 释放 startup benchmark 复用的宿主对象。 /// [GlobalCleanup] public void Cleanup() { _serviceProvider.Dispose(); } /// /// 返回已构建宿主中的 MediatR mediator,作为 initialization 组的句柄解析 baseline。 /// [Benchmark(Baseline = true)] [BenchmarkCategory("Initialization")] public IMediator Initialization_MediatR() { return _mediatr; } /// /// 返回已构建宿主中的 GFramework.CQRS runtime,确保与 MediatR baseline 处于相同初始化阶段。 /// [Benchmark] [BenchmarkCategory("Initialization")] public ICqrsRuntime Initialization_GFrameworkCqrs() { return _runtime; } /// /// 在新宿主上首次发送 request,作为 MediatR 的 cold-start baseline。 /// [Benchmark(Baseline = true)] [BenchmarkCategory("ColdStart")] public async Task ColdStart_MediatR() { using var serviceProvider = CreateMediatRServiceProvider(); var mediator = serviceProvider.GetRequiredService(); return await mediator.Send(Request, CancellationToken.None).ConfigureAwait(false); } /// /// 在新 runtime 上首次发送 request,量化 GFramework.CQRS 的 first-hit 成本。 /// [Benchmark] [BenchmarkCategory("ColdStart")] public ValueTask ColdStart_GFrameworkCqrs() { var runtime = CreateGFrameworkRuntime(); return runtime.SendAsync(BenchmarkContext.Instance, Request, CancellationToken.None); } /// /// 构建只承载当前 benchmark request 的最小 GFramework.CQRS runtime。 /// /// /// 该 benchmark 故意保持与 MediatR 对照组同样的“单 handler 最小宿主”模型, /// 因此这里继续使用单点手工注册,而不引入依赖完整 CQRS 注册协调器的程序集扫描路径。 /// private static ICqrsRuntime CreateGFrameworkRuntime() { var container = BenchmarkHostFactory.CreateFrozenGFrameworkContainer(static currentContainer => { currentContainer.RegisterTransient, BenchmarkRequestHandler>(); }); return GFramework.Cqrs.CqrsRuntimeFactory.CreateRuntime(container, RuntimeLogger); } /// /// 构建只承载当前 benchmark request 的最小 MediatR 对照宿主。 /// private static ServiceProvider CreateMediatRServiceProvider() { return BenchmarkHostFactory.CreateMediatRServiceProvider( configure: null, typeof(RequestStartupBenchmarks), static candidateType => candidateType == typeof(BenchmarkRequestHandler), ServiceLifetime.Transient); } /// /// 为 benchmark 创建稳定的 fatal 级 logger,避免把日志成本混入 startup 测量。 /// private static ILogger CreateLogger(string categoryName) { LoggerFactoryResolver.Provider = new ConsoleLoggerFactoryProvider { MinLevel = LogLevel.Fatal }; return LoggerFactoryResolver.Provider.CreateLogger(categoryName); } /// /// Benchmark request。 /// /// 请求标识。 public sealed record BenchmarkRequest(Guid Id) : GFramework.Cqrs.Abstractions.Cqrs.IRequest, MediatR.IRequest; /// /// Benchmark response。 /// /// 响应标识。 public sealed record BenchmarkResponse(Guid Id); /// /// 同时实现 GFramework.CQRS 与 MediatR 契约的最小 request handler。 /// public sealed class BenchmarkRequestHandler : GFramework.Cqrs.Abstractions.Cqrs.IRequestHandler, MediatR.IRequestHandler { /// /// 处理 GFramework.CQRS request。 /// public ValueTask Handle(BenchmarkRequest request, CancellationToken cancellationToken) { return ValueTask.FromResult(new BenchmarkResponse(request.Id)); } /// /// 处理 MediatR request。 /// Task MediatR.IRequestHandler.Handle( BenchmarkRequest request, CancellationToken cancellationToken) { return Task.FromResult(new BenchmarkResponse(request.Id)); } } }