Snowberry.Mediator.Extensions.DependencyInjection
3.0.0
dotnet add package Snowberry.Mediator.Extensions.DependencyInjection --version 3.0.0
NuGet\Install-Package Snowberry.Mediator.Extensions.DependencyInjection -Version 3.0.0
<PackageReference Include="Snowberry.Mediator.Extensions.DependencyInjection" Version="3.0.0" />
<PackageVersion Include="Snowberry.Mediator.Extensions.DependencyInjection" Version="3.0.0" />
<PackageReference Include="Snowberry.Mediator.Extensions.DependencyInjection" />
paket add Snowberry.Mediator.Extensions.DependencyInjection --version 3.0.0
#r "nuget: Snowberry.Mediator.Extensions.DependencyInjection, 3.0.0"
#:package Snowberry.Mediator.Extensions.DependencyInjection@3.0.0
#addin nuget:?package=Snowberry.Mediator.Extensions.DependencyInjection&version=3.0.0
#tool nuget:?package=Snowberry.Mediator.Extensions.DependencyInjection&version=3.0.0
Snowberry.Mediator.Extensions.DependencyInjection
The Microsoft.Extensions.DependencyInjection integration for Snowberry.Mediator. It adds AddSnowberryMediator to IServiceCollection, registering IMediator, request and stream handlers, pipeline behaviors and notification handlers by assembly scanning or explicit type lists. It targets net11.0, net10.0 and netstandard2.0.
For the Snowberry.DependencyInjection container use Snowberry.Mediator.DependencyInjection instead. For trimmed or Native AOT apps, pair this package with the source generator.
Table of Contents
- Installation
- Quick Start
- Registration Options
- Adding Handlers Later
- OpenTelemetry
- Pitfalls
- Related Packages
Installation
dotnet add package Snowberry.Mediator.Extensions.DependencyInjection
Quick Start
using Microsoft.Extensions.DependencyInjection;
using Snowberry.Mediator.Abstractions;
using Snowberry.Mediator.Extensions.DependencyInjection;
var services = new ServiceCollection();
services.AddSnowberryMediator(options =>
{
options.RequestHandlerTypes = [typeof(MyRequestHandler)];
options.StreamRequestHandlerTypes = [typeof(MyStreamRequestHandler)];
options.NotificationHandlerTypes = [typeof(MyNotificationHandler)];
options.PipelineBehaviorTypes = [typeof(MyPipelineBehavior<,>)];
options.StreamPipelineBehaviorTypes = [typeof(MyStreamPipelineBehavior<,>)];
});
using var provider = services.BuildServiceProvider();
using var scope = provider.CreateScope();
var mediator = scope.ServiceProvider.GetRequiredService<IMediator>();
ServiceCollection and BuildServiceProvider come from the Microsoft.Extensions.DependencyInjection package; this integration itself only depends on the abstractions.
Registration Options
public static IServiceCollection AddSnowberryMediator(
this IServiceCollection services,
Action<MediatorOptions> configure,
ServiceLifetime serviceLifetime = ServiceLifetime.Scoped,
bool append = false)
serviceLifetimeapplies toIMediatorand every handler and behavior. The global registries are singletons.Assembly scanning registers request and stream handlers from
options.Assemblies; setScanPipelineBehaviors,ScanStreamPipelineBehaviorsandScanNotificationHandlersto scan the other categories too:services.AddSnowberryMediator(options => { options.Assemblies = [typeof(MyRequestHandler).Assembly]; options.ScanPipelineBehaviors = true; options.ScanNotificationHandlers = true; });Explicit lists keep the order of
PipelineBehaviorTypes/StreamPipelineBehaviorTypes, unless a behavior carries[PipelineOverwritePriority].
The full MediatorOptions table is in the main README.
Adding Handlers Later
Registration uses TryAdd: an existing IMediator or handler is never replaced. A second call that would register behaviors or notification handlers while a registry already exists throws InvalidOperationException. Pass append: true to add handlers to the existing registries instead, for example from a plugin or feature module:
services.AddSnowberryMediator(options =>
{
options.NotificationHandlerTypes = [typeof(PluginNotificationHandler)];
}, append: true);
OpenTelemetry
Add Snowberry.Mediator.Extensions.OpenTelemetry and call AddSnowberryMediatorOpenTelemetry after AddSnowberryMediator; calling it first throws InvalidOperationException.
Pitfalls
- This entry point is not AOT-safe, even with explicit lists. It carries
[RequiresUnreferencedCode]and[RequiresDynamicCode]because it inspects handler interfaces and closes generic types at runtime, so trimmed and AOT builds warn (IL2026,IL3050). Use the source generator'sAddSnowberryMediator()there. - Scanning skips behaviors and notification handlers by default. Without the
Scan*flags only request and stream handlers are found. - Second calls need
append: true. Otherwise adding behaviors or notification handlers a second time throws. - There is no
AppendSnowberryMediatorhere. That method belongs to theSnowberry.DependencyInjectionintegration; this package uses theappendparameter.
Related Packages
| Package | Purpose |
|---|---|
Snowberry.Mediator |
The mediator implementation. |
Snowberry.Mediator.SourceGenerator |
Generated, AOT-safe AddSnowberryMediator() for IServiceCollection. |
Snowberry.Mediator.Extensions.OpenTelemetry |
OpenTelemetry decorator for this container. |
Snowberry.Mediator.DependencyInjection |
The equivalent integration for Snowberry.DependencyInjection. |
Snowberry.Mediator.DependencyInjection.Shared |
The container-agnostic helper this package builds on. |
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. net11.0 is compatible. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.6)
- Snowberry.Mediator (>= 3.0.0)
- Snowberry.Mediator.DependencyInjection.Shared (>= 3.0.0)
-
net10.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.6)
- Snowberry.Mediator (>= 3.0.0)
- Snowberry.Mediator.DependencyInjection.Shared (>= 3.0.0)
-
net11.0
- Snowberry.Mediator (>= 3.0.0)
- Snowberry.Mediator.DependencyInjection.Shared (>= 3.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 3.0.0 | 122 | 11/12/2026 |
| 2.0.0 | 5,089 | 6/1/2026 |
| 1.1.0 | 978 | 1/28/2026 |
| 1.0.4-alpha | 275 | 11/15/2025 |
| 1.0.3-alpha | 263 | 11/4/2025 |
| 1.0.2-alpha | 235 | 10/7/2025 |
| 1.0.1-alpha | 241 | 9/23/2025 |
| 1.0.0-alpha | 251 | 9/9/2025 |