// 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; namespace GFramework.Cqrs.Benchmarks.Messaging; /// /// 对比 request steady-state dispatch 在不同 handler 生命周期下的额外开销。 /// /// /// 当前矩阵只覆盖 `Singleton` 与 `Transient`。 /// `Scoped` 在两个 runtime 中都依赖显式作用域边界,而当前 benchmark 宿主故意保持“单根容器最小宿主”模型, /// 直接把 scoped 解析压到根作用域会让对照语义失真,因此留到未来有真实 scoped host 基线时再扩展。 /// [Config(typeof(Config))] public class RequestLifetimeBenchmarks { private MicrosoftDiContainer _container = null!; private ICqrsRuntime _runtime = null!; private ServiceProvider _serviceProvider = null!; private IMediator _mediatr = null!; private BenchmarkRequestHandler _baselineHandler = null!; private BenchmarkRequest _request = null!; /// /// 控制当前 benchmark 使用的 handler 生命周期。 /// [Params(HandlerLifetime.Singleton, HandlerLifetime.Transient)] public HandlerLifetime Lifetime { get; set; } /// /// 可公平比较的 benchmark handler 生命周期集合。 /// public enum HandlerLifetime { /// /// 复用单个 handler 实例。 /// Singleton, /// /// 每次分发都重新解析新的 handler 实例。 /// Transient } /// /// 配置 request lifetime benchmark 的公共输出格式。 /// private sealed class Config : ManualConfig { public Config() { AddJob(Job.Default); AddColumnProvider(DefaultColumnProviders.Instance); AddColumn(new CustomColumn("Scenario", static (_, _) => "RequestLifetime")); AddDiagnoser(MemoryDiagnoser.Default); WithOrderer(new DefaultOrderer(SummaryOrderPolicy.FastestToSlowest, MethodOrderPolicy.Declared)); } } /// /// 构建当前生命周期下的 GFramework 与 MediatR request 对照宿主。 /// [GlobalSetup] public void Setup() { LoggerFactoryResolver.Provider = new ConsoleLoggerFactoryProvider { MinLevel = LogLevel.Fatal }; Fixture.Setup($"RequestLifetime/{Lifetime}", handlerCount: 1, pipelineCount: 0); _baselineHandler = new BenchmarkRequestHandler(); _request = new BenchmarkRequest(Guid.NewGuid()); _container = BenchmarkHostFactory.CreateFrozenGFrameworkContainer(container => { RegisterGFrameworkHandler(container, Lifetime); }); _runtime = GFramework.Cqrs.CqrsRuntimeFactory.CreateRuntime( _container, LoggerFactoryResolver.Provider.CreateLogger(nameof(RequestLifetimeBenchmarks) + "." + Lifetime)); _serviceProvider = BenchmarkHostFactory.CreateMediatRServiceProvider( configure: null, typeof(RequestLifetimeBenchmarks), static candidateType => candidateType == typeof(BenchmarkRequestHandler), ResolveMediatRLifetime(Lifetime)); _mediatr = _serviceProvider.GetRequiredService(); } /// /// 释放当前生命周期矩阵持有的 benchmark 宿主资源。 /// [GlobalCleanup] public void Cleanup() { BenchmarkCleanupHelper.DisposeAll(_container, _serviceProvider); } /// /// 直接调用 handler,作为不同生命周期矩阵下的 dispatch 额外开销 baseline。 /// [Benchmark(Baseline = true)] public ValueTask SendRequest_Baseline() { return _baselineHandler.Handle(_request, CancellationToken.None); } /// /// 通过 GFramework.CQRS runtime 发送 request。 /// [Benchmark] public ValueTask SendRequest_GFrameworkCqrs() { return _runtime.SendAsync(BenchmarkContext.Instance, _request, CancellationToken.None); } /// /// 通过 MediatR 发送 request,作为外部对照。 /// [Benchmark] public Task SendRequest_MediatR() { return _mediatr.Send(_request, CancellationToken.None); } /// /// 按生命周期把 benchmark request handler 注册到 GFramework 容器。 /// /// 当前 benchmark 拥有并负责释放的容器。 /// 待比较的 handler 生命周期。 private static void RegisterGFrameworkHandler(MicrosoftDiContainer container, HandlerLifetime lifetime) { ArgumentNullException.ThrowIfNull(container); switch (lifetime) { case HandlerLifetime.Singleton: container.RegisterSingleton, BenchmarkRequestHandler>(); return; case HandlerLifetime.Transient: container.RegisterTransient, BenchmarkRequestHandler>(); return; default: throw new ArgumentOutOfRangeException(nameof(lifetime), lifetime, "Unsupported benchmark handler lifetime."); } } /// /// 将 benchmark 生命周期映射为 MediatR 组装所需的 。 /// /// 待比较的 handler 生命周期。 private static ServiceLifetime ResolveMediatRLifetime(HandlerLifetime lifetime) { return lifetime switch { HandlerLifetime.Singleton => ServiceLifetime.Singleton, HandlerLifetime.Transient => ServiceLifetime.Transient, _ => throw new ArgumentOutOfRangeException(nameof(lifetime), lifetime, "Unsupported benchmark handler lifetime.") }; } /// /// 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)); } } }