// 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;
///
/// 对比固定 4 个处理器的 notification fan-out publish 在 baseline、GFramework.CQRS、NuGet `Mediator`
/// 与 MediatR 之间的开销。
///
[Config(typeof(Config))]
public class NotificationFanOutBenchmarks
{
private MicrosoftDiContainer _container = null!;
private ICqrsRuntime _runtime = null!;
private ServiceProvider _mediatrServiceProvider = null!;
private ServiceProvider _mediatorServiceProvider = null!;
private IPublisher _mediatrPublisher = null!;
private GeneratedMediator _mediator = null!;
private BenchmarkNotification _notification = null!;
private BenchmarkNotificationHandler1 _baselineHandler1 = null!;
private BenchmarkNotificationHandler2 _baselineHandler2 = null!;
private BenchmarkNotificationHandler3 _baselineHandler3 = null!;
private BenchmarkNotificationHandler4 _baselineHandler4 = null!;
///
/// 配置 notification fan-out benchmark 的公共输出格式。
///
private sealed class Config : ManualConfig
{
public Config()
{
AddJob(Job.Default);
AddColumnProvider(DefaultColumnProviders.Instance);
AddColumn(new CustomColumn("Scenario", static (_, _) => "NotificationFanOut"));
AddDiagnoser(MemoryDiagnoser.Default);
WithOrderer(new DefaultOrderer(SummaryOrderPolicy.FastestToSlowest, MethodOrderPolicy.Declared));
}
}
///
/// 构建固定 4 处理器 notification publish 所需的最小 runtime 宿主和对照对象。
///
[GlobalSetup]
public void Setup()
{
LoggerFactoryResolver.Provider = new ConsoleLoggerFactoryProvider
{
MinLevel = LogLevel.Fatal
};
Fixture.Setup("NotificationFanOut", handlerCount: 4, pipelineCount: 0);
_baselineHandler1 = new BenchmarkNotificationHandler1();
_baselineHandler2 = new BenchmarkNotificationHandler2();
_baselineHandler3 = new BenchmarkNotificationHandler3();
_baselineHandler4 = new BenchmarkNotificationHandler4();
_container = BenchmarkHostFactory.CreateFrozenGFrameworkContainer(container =>
{
container.RegisterSingleton, BenchmarkNotificationHandler1>();
container.RegisterSingleton, BenchmarkNotificationHandler2>();
container.RegisterSingleton, BenchmarkNotificationHandler3>();
container.RegisterSingleton, BenchmarkNotificationHandler4>();
});
_runtime = GFramework.Cqrs.CqrsRuntimeFactory.CreateRuntime(
_container,
LoggerFactoryResolver.Provider.CreateLogger(nameof(NotificationFanOutBenchmarks)));
_mediatrServiceProvider = BenchmarkHostFactory.CreateMediatRServiceProvider(
services =>
{
services.AddSingleton, BenchmarkNotificationHandler1>();
services.AddSingleton, BenchmarkNotificationHandler2>();
services.AddSingleton, BenchmarkNotificationHandler3>();
services.AddSingleton, BenchmarkNotificationHandler4>();
},
typeof(NotificationFanOutBenchmarks),
static candidateType =>
candidateType == typeof(BenchmarkNotificationHandler1) ||
candidateType == typeof(BenchmarkNotificationHandler2) ||
candidateType == typeof(BenchmarkNotificationHandler3) ||
candidateType == typeof(BenchmarkNotificationHandler4),
ServiceLifetime.Singleton);
_mediatrPublisher = _mediatrServiceProvider.GetRequiredService();
_mediatorServiceProvider = BenchmarkHostFactory.CreateMediatorServiceProvider(configure: null);
_mediator = _mediatorServiceProvider.GetRequiredService();
_notification = new BenchmarkNotification(Guid.NewGuid());
}
///
/// 释放 MediatR 与 `Mediator` 对照组使用的 DI 宿主。
///
[GlobalCleanup]
public void Cleanup()
{
BenchmarkCleanupHelper.DisposeAll(_container, _mediatrServiceProvider, _mediatorServiceProvider);
}
///
/// 直接依次调用 4 个处理器,作为 fan-out dispatch 额外开销的 baseline。
///
[Benchmark(Baseline = true)]
public async ValueTask PublishNotification_Baseline()
{
await _baselineHandler1.Handle(_notification, CancellationToken.None).ConfigureAwait(false);
await _baselineHandler2.Handle(_notification, CancellationToken.None).ConfigureAwait(false);
await _baselineHandler3.Handle(_notification, CancellationToken.None).ConfigureAwait(false);
await _baselineHandler4.Handle(_notification, CancellationToken.None).ConfigureAwait(false);
}
///
/// 通过 GFramework.CQRS runtime 发布固定 4 处理器的 notification。
///
[Benchmark]
public ValueTask PublishNotification_GFrameworkCqrs()
{
return _runtime.PublishAsync(BenchmarkContext.Instance, _notification, CancellationToken.None);
}
///
/// 通过 MediatR 发布固定 4 处理器的 notification,作为外部设计对照。
///
[Benchmark]
public Task PublishNotification_MediatR()
{
return _mediatrPublisher.Publish(_notification, CancellationToken.None);
}
///
/// 通过 `Mediator` source-generated concrete mediator 发布固定 4 处理器的 notification,作为高性能对照组。
///
[Benchmark]
public ValueTask PublishNotification_Mediator()
{
return _mediator.Publish(_notification, CancellationToken.None);
}
///
/// Benchmark notification。
///
/// 通知标识。
public sealed record BenchmarkNotification(Guid Id) :
GFramework.Cqrs.Abstractions.Cqrs.INotification,
Mediator.INotification,
MediatR.INotification;
///
/// 为 fan-out benchmark 提供统一的 no-op 处理逻辑。
///
public abstract class BenchmarkNotificationHandlerBase
{
///
/// 执行 benchmark 使用的最小处理逻辑。
///
/// 当前 notification。
/// 取消令牌。
/// 已完成的值任务。
protected static ValueTask HandleCore(BenchmarkNotification notification, CancellationToken cancellationToken)
{
ArgumentNullException.ThrowIfNull(notification);
cancellationToken.ThrowIfCancellationRequested();
return ValueTask.CompletedTask;
}
}
///
/// fan-out benchmark 的第 1 个 notification handler。
///
public sealed class BenchmarkNotificationHandler1 :
BenchmarkNotificationHandlerBase,
GFramework.Cqrs.Abstractions.Cqrs.INotificationHandler,
Mediator.INotificationHandler,
MediatR.INotificationHandler
{
///
/// 处理 GFramework.CQRS notification。
///
public ValueTask Handle(BenchmarkNotification notification, CancellationToken cancellationToken)
{
return HandleCore(notification, cancellationToken);
}
///
/// 处理 NuGet `Mediator` notification。
///
ValueTask Mediator.INotificationHandler.Handle(
BenchmarkNotification notification,
CancellationToken cancellationToken)
{
return HandleCore(notification, cancellationToken);
}
///
/// 处理 MediatR notification。
///
Task MediatR.INotificationHandler.Handle(
BenchmarkNotification notification,
CancellationToken cancellationToken)
{
return Task.CompletedTask;
}
}
///
/// fan-out benchmark 的第 2 个 notification handler。
///
public sealed class BenchmarkNotificationHandler2 :
BenchmarkNotificationHandlerBase,
GFramework.Cqrs.Abstractions.Cqrs.INotificationHandler,
Mediator.INotificationHandler,
MediatR.INotificationHandler
{
///
/// 处理 GFramework.CQRS notification。
///
public ValueTask Handle(BenchmarkNotification notification, CancellationToken cancellationToken)
{
return HandleCore(notification, cancellationToken);
}
///
/// 处理 NuGet `Mediator` notification。
///
ValueTask Mediator.INotificationHandler.Handle(
BenchmarkNotification notification,
CancellationToken cancellationToken)
{
return HandleCore(notification, cancellationToken);
}
///
/// 处理 MediatR notification。
///
Task MediatR.INotificationHandler.Handle(
BenchmarkNotification notification,
CancellationToken cancellationToken)
{
return Task.CompletedTask;
}
}
///
/// fan-out benchmark 的第 3 个 notification handler。
///
public sealed class BenchmarkNotificationHandler3 :
BenchmarkNotificationHandlerBase,
GFramework.Cqrs.Abstractions.Cqrs.INotificationHandler,
Mediator.INotificationHandler,
MediatR.INotificationHandler
{
///
/// 处理 GFramework.CQRS notification。
///
public ValueTask Handle(BenchmarkNotification notification, CancellationToken cancellationToken)
{
return HandleCore(notification, cancellationToken);
}
///
/// 处理 NuGet `Mediator` notification。
///
ValueTask Mediator.INotificationHandler.Handle(
BenchmarkNotification notification,
CancellationToken cancellationToken)
{
return HandleCore(notification, cancellationToken);
}
///
/// 处理 MediatR notification。
///
Task MediatR.INotificationHandler.Handle(
BenchmarkNotification notification,
CancellationToken cancellationToken)
{
return Task.CompletedTask;
}
}
///
/// fan-out benchmark 的第 4 个 notification handler。
///
public sealed class BenchmarkNotificationHandler4 :
BenchmarkNotificationHandlerBase,
GFramework.Cqrs.Abstractions.Cqrs.INotificationHandler,
Mediator.INotificationHandler,
MediatR.INotificationHandler
{
///
/// 处理 GFramework.CQRS notification。
///
public ValueTask Handle(BenchmarkNotification notification, CancellationToken cancellationToken)
{
return HandleCore(notification, cancellationToken);
}
///
/// 处理 NuGet `Mediator` notification。
///
ValueTask Mediator.INotificationHandler.Handle(
BenchmarkNotification notification,
CancellationToken cancellationToken)
{
return HandleCore(notification, cancellationToken);
}
///
/// 处理 MediatR notification。
///
Task MediatR.INotificationHandler.Handle(
BenchmarkNotification notification,
CancellationToken cancellationToken)
{
return Task.CompletedTask;
}
}
}