// 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));
}
}
}