// 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);
_container = new MicrosoftDiContainer();
_baselineHandler = new BenchmarkRequestHandler();
_container.RegisterTransient, BenchmarkRequestHandler>();
RegisterGFrameworkPipelineBehaviors(_container, PipelineCount);
_runtime = GFramework.Cqrs.CqrsRuntimeFactory.CreateRuntime(
_container,
LoggerFactoryResolver.Provider.CreateLogger(nameof(RequestPipelineBenchmarks)));
var services = new ServiceCollection();
services.AddLogging(static builder =>
Microsoft.Extensions.Logging.FilterLoggingBuilderExtensions.AddFilter(
builder,
"LuckyPennySoftware.MediatR.License",
Microsoft.Extensions.Logging.LogLevel.None));
services.AddSingleton, BenchmarkRequestHandler>();
RegisterMediatRPipelineBehaviors(services, PipelineCount);
services.AddMediatR(static options => options.RegisterServicesFromAssembly(typeof(RequestPipelineBenchmarks).Assembly));
_serviceProvider = services.BuildServiceProvider();
_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;
}