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