// 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; /// /// 对比不同 pipeline 行为数量下,单个 request 在直接调用、GFramework.CQRS runtime 与 MediatR 之间的 steady-state dispatch 开销。 /// [Config(typeof(Config))] public class RequestPipelineBenchmarks { private MicrosoftDiContainer _container = null!; private ICqrsRuntime _runtime = null!; private ServiceProvider _serviceProvider = null!; private IMediator _mediatr = null!; private BenchmarkRequestHandler _baselineHandler = null!; private BenchmarkRequest _request = null!; /// /// 控制当前场景注册的 pipeline 行为数量,保持与 `Mediator` benchmark 常见的“无行为 / 少量行为 / 多行为”矩阵一致。 /// [Params(0, 1, 4)] public int PipelineCount { get; set; } /// /// 配置 request pipeline benchmark 的公共输出格式。 /// private sealed class Config : ManualConfig { public Config() { AddJob(Job.Default); AddColumnProvider(DefaultColumnProviders.Instance); AddColumn(new CustomColumn("Scenario", static (_, _) => "RequestPipeline")); AddDiagnoser(MemoryDiagnoser.Default); WithOrderer(new DefaultOrderer(SummaryOrderPolicy.FastestToSlowest, MethodOrderPolicy.Declared)); } } /// /// 构建 request pipeline dispatch 所需的最小 runtime 宿主和对照对象。 /// [GlobalSetup] public void Setup() { LoggerFactoryResolver.Provider = new ConsoleLoggerFactoryProvider { MinLevel = LogLevel.Fatal }; Fixture.Setup("RequestPipeline", handlerCount: 1, pipelineCount: PipelineCount); _baselineHandler = new BenchmarkRequestHandler(); _container = BenchmarkHostFactory.CreateFrozenGFrameworkContainer(container => { container.RegisterSingleton>( _baselineHandler); RegisterGFrameworkPipelineBehaviors(container, PipelineCount); }); _runtime = GFramework.Cqrs.CqrsRuntimeFactory.CreateRuntime( _container, LoggerFactoryResolver.Provider.CreateLogger(nameof(RequestPipelineBenchmarks))); _serviceProvider = BenchmarkHostFactory.CreateMediatRServiceProvider( services => { RegisterMediatRPipelineBehaviors(services, PipelineCount); }, typeof(RequestPipelineBenchmarks), static candidateType => candidateType == typeof(BenchmarkRequestHandler) || candidateType == typeof(BenchmarkPipelineBehavior1) || candidateType == typeof(BenchmarkPipelineBehavior2) || candidateType == typeof(BenchmarkPipelineBehavior3) || candidateType == typeof(BenchmarkPipelineBehavior4), ServiceLifetime.Singleton); _mediatr = _serviceProvider.GetRequiredService(); _request = new BenchmarkRequest(Guid.NewGuid()); } /// /// 释放 MediatR 对照组使用的 DI 宿主。 /// [GlobalCleanup] public void Cleanup() { _serviceProvider.Dispose(); } /// /// 直接调用 handler,作为 pipeline 编排之外的基线。 /// [Benchmark(Baseline = true)] public ValueTask SendRequest_Baseline() { return _baselineHandler.Handle(_request, CancellationToken.None); } /// /// 通过 GFramework.CQRS runtime 发送 request,并按当前矩阵配置执行 pipeline。 /// [Benchmark] public ValueTask SendRequest_GFrameworkCqrs() { return _runtime.SendAsync(BenchmarkContext.Instance, _request, CancellationToken.None); } /// /// 通过 MediatR 发送 request,并按当前矩阵配置执行 pipeline,作为外部设计对照。 /// [Benchmark] public Task SendRequest_MediatR() { return _mediatr.Send(_request, CancellationToken.None); } /// /// 按指定数量向 GFramework.CQRS 宿主注册最小 no-op pipeline 行为。 /// /// 当前 benchmark 使用的容器。 /// 要注册的行为数量。 /// 行为数量不在支持的矩阵内时抛出。 private static void RegisterGFrameworkPipelineBehaviors(MicrosoftDiContainer container, int pipelineCount) { ArgumentNullException.ThrowIfNull(container); switch (pipelineCount) { case 0: return; case 1: container.RegisterCqrsPipelineBehavior(); return; case 4: container.RegisterCqrsPipelineBehavior(); container.RegisterCqrsPipelineBehavior(); container.RegisterCqrsPipelineBehavior(); container.RegisterCqrsPipelineBehavior(); return; default: throw new ArgumentOutOfRangeException(nameof(pipelineCount), pipelineCount, "Only the 0/1/4 pipeline matrix is supported."); } } /// /// 按指定数量向 MediatR 宿主注册最小 no-op pipeline 行为。 /// /// 当前 benchmark 使用的服务集合。 /// 要注册的行为数量。 /// 行为数量不在支持的矩阵内时抛出。 private static void RegisterMediatRPipelineBehaviors(IServiceCollection services, int pipelineCount) { ArgumentNullException.ThrowIfNull(services); switch (pipelineCount) { case 0: return; case 1: services.AddSingleton, BenchmarkPipelineBehavior1>(); return; case 4: services.AddSingleton, BenchmarkPipelineBehavior1>(); services.AddSingleton, BenchmarkPipelineBehavior2>(); services.AddSingleton, BenchmarkPipelineBehavior3>(); services.AddSingleton, BenchmarkPipelineBehavior4>(); return; default: throw new ArgumentOutOfRangeException(nameof(pipelineCount), pipelineCount, "Only the 0/1/4 pipeline matrix is supported."); } } /// /// 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)); } } /// /// 为 benchmark 提供统一的 no-op pipeline 行为实现,尽量把测量焦点保持在调度器与行为编排本身。 /// public abstract class BenchmarkPipelineBehaviorBase : GFramework.Cqrs.Abstractions.Cqrs.IPipelineBehavior, MediatR.IPipelineBehavior { /// /// 透传 GFramework.CQRS pipeline,避免引入额外业务逻辑噪音。 /// public ValueTask Handle( BenchmarkRequest message, GFramework.Cqrs.Abstractions.Cqrs.MessageHandlerDelegate next, CancellationToken cancellationToken) { return next(message, cancellationToken); } /// /// 透传 MediatR pipeline,保持与 GFramework.CQRS 相同的 no-op 语义。 /// Task MediatR.IPipelineBehavior.Handle( BenchmarkRequest request, RequestHandlerDelegate next, CancellationToken cancellationToken) { return next(); } } /// /// pipeline 行为槽位 1。 /// public sealed class BenchmarkPipelineBehavior1 : BenchmarkPipelineBehaviorBase; /// /// pipeline 行为槽位 2。 /// public sealed class BenchmarkPipelineBehavior2 : BenchmarkPipelineBehaviorBase; /// /// pipeline 行为槽位 3。 /// public sealed class BenchmarkPipelineBehavior3 : BenchmarkPipelineBehaviorBase; /// /// pipeline 行为槽位 4。 /// public sealed class BenchmarkPipelineBehavior4 : BenchmarkPipelineBehaviorBase; }