MediatR 12.4.0

MediatR

.NET 中的简单中介实现

无依赖的进程内消息传递。

支持请求/响应、命令、查询、通知和事件，同步和异步，通过 C# 泛型变体智能调度。

wiki 中的示例。

安装 MediatR

您应该使用 NuGet 安装 MediatR

Install-Package MediatR

或通过 .NET Core 命令行界面

dotnet add package MediatR

无论是命令还是从包管理器控制台或 .NET Core CLI，都会下载并安装 MediatR 及所有必需的依赖项。

使用仅合约包

要仅引用 MediatR 的合约，它包括

• IRequest（包括泛型变体）
• INotification
• IStreamRequest

将包引用添加到 MediatR.Contracts

该软件包适用于您的MediatR契约与处理器位于不同的组件/项目中的场景。例如，以下场景：

• API契约
• GRPC契约
• Blazor

使用IServiceCollection进行注册

MediatR直接支持 Microsoft.Extensions.DependencyInjection.Abstractions。要注册各种MediatR服务和处理器

services.AddMediatR(cfg => cfg.RegisterServicesFromAssemblyContaining<Startup>());

或使用一个组件

services.AddMediatR(cfg => cfg.RegisterServicesFromAssembly(typeof(Startup).Assembly));

这会进行以下注册：

• IMediator 作为短暂的
• ISender 作为短暂的
• IPublisher 作为短暂的
• IRequestHandler<,> 具体实现作为短暂的
• IRequestHandler<> 具体实现作为短暂的
• INotificationHandler<> 具体实现作为短暂的
• IStreamRequestHandler<> 具体实现作为短暂的
• IRequestExceptionHandler<,,> 具体实现作为短暂的
• IRequestExceptionAction<,> 具体实现作为短暂的

这还为您注册了以下开放泛型实现：

• INotificationHandler<>
• IRequestExceptionHandler<,,>
• IRequestExceptionAction<>

要注册行为、流行为、预处理程序和后处理程序

services.AddMediatR(cfg => {
    cfg.RegisterServicesFromAssembly(typeof(Startup).Assembly);
    cfg.AddBehavior<PingPongBehavior>();
    cfg.AddStreamBehavior<PingPongStreamBehavior>();
    cfg.AddRequestPreProcessor<PingPreProcessor>();
    cfg.AddRequestPostProcessor<PingPongPostProcessor>();
    cfg.AddOpenBehavior(typeof(GenericBehavior<,>));
    });

提供额外的开放泛型方法和对显式服务类型的重载。