// 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 GeneratedMediator = Mediator.Mediator; namespace GFramework.Cqrs.Benchmarks.Messaging; /// /// 对比单个 request 在直接调用、GFramework.CQRS runtime、NuGet `Mediator` 与 MediatR 之间的 steady-state dispatch 开销。 /// [Config(typeof(Config))] public class RequestBenchmarks { private MicrosoftDiContainer _container = null!; private ICqrsRuntime _runtime = null!; private ServiceProvider _mediatrServiceProvider = null!; private ServiceProvider _mediatorServiceProvider = null!; private IMediator _mediatr = null!; private GeneratedMediator _mediator = null!; private BenchmarkRequestHandler _baselineHandler = null!; private BenchmarkRequest _request = null!; /// /// 配置 request benchmark 的公共输出格式。 /// private sealed class Config : ManualConfig { public Config() { AddJob(Job.Default); AddColumnProvider(DefaultColumnProviders.Instance); AddColumn(new CustomColumn("Scenario", static (_, _) => "Request")); AddDiagnoser(MemoryDiagnoser.Default); WithOrderer(new DefaultOrderer(SummaryOrderPolicy.FastestToSlowest, MethodOrderPolicy.Declared)); } } /// /// 构建 request dispatch 所需的最小 runtime 宿主和对照对象。 /// [GlobalSetup] public void Setup() { LoggerFactoryResolver.Provider = new ConsoleLoggerFactoryProvider { MinLevel = LogLevel.Fatal }; Fixture.Setup("Request", handlerCount: 1, pipelineCount: 0); BenchmarkDispatcherCacheHelper.ClearDispatcherCaches(); _baselineHandler = new BenchmarkRequestHandler(); _container = BenchmarkHostFactory.CreateFrozenGFrameworkContainer(container => { BenchmarkHostFactory.RegisterGeneratedBenchmarkRegistry(container); }); _runtime = GFramework.Cqrs.CqrsRuntimeFactory.CreateRuntime( _container, LoggerFactoryResolver.Provider.CreateLogger(nameof(RequestBenchmarks))); _mediatrServiceProvider = BenchmarkHostFactory.CreateMediatRServiceProvider( configure: null, typeof(RequestBenchmarks), static candidateType => candidateType == typeof(BenchmarkRequestHandler), ServiceLifetime.Singleton); _mediatr = _mediatrServiceProvider.GetRequiredService(); _mediatorServiceProvider = BenchmarkHostFactory.CreateMediatorServiceProvider(configure: null); _mediator = _mediatorServiceProvider.GetRequiredService(); _request = new BenchmarkRequest(Guid.NewGuid()); } /// /// 释放 MediatR 与 `Mediator` 对照组使用的 DI 宿主。 /// [GlobalCleanup] public void Cleanup() { try { BenchmarkCleanupHelper.DisposeAll(_container, _mediatrServiceProvider, _mediatorServiceProvider); } finally { BenchmarkDispatcherCacheHelper.ClearDispatcherCaches(); } } /// /// 直接调用 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); } /// /// 通过 `ai-libs/Mediator` 的 source-generated concrete mediator 发送 request,作为高性能对照组。 /// [Benchmark] public ValueTask SendRequest_Mediator() { return _mediator.Send(_request, CancellationToken.None); } /// /// Benchmark request。 /// /// 请求标识。 public sealed record BenchmarkRequest(Guid Id) : GFramework.Cqrs.Abstractions.Cqrs.IRequest, Mediator.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, Mediator.IRequestHandler, MediatR.IRequestHandler { /// /// 处理 GFramework.CQRS request。 /// public ValueTask Handle(BenchmarkRequest request, CancellationToken cancellationToken) { return ValueTask.FromResult(new BenchmarkResponse(request.Id)); } /// /// 处理 NuGet `Mediator` request。 /// ValueTask Mediator.IRequestHandler.Handle( BenchmarkRequest request, CancellationToken cancellationToken) { return Handle(request, cancellationToken); } /// /// 处理 MediatR request。 /// Task MediatR.IRequestHandler.Handle( BenchmarkRequest request, CancellationToken cancellationToken) { return Task.FromResult(new BenchmarkResponse(request.Id)); } } }