MediatR.ParallelPublisher

MediatR.ParallelPublisher is an extension for MediatR that enables parallel and fire-and-forget publishing of notifications. The library aims to improve performance and responsiveness by executing notification handlers concurrently, while also providing exception handling mechanisms for notification processing.

Features

• Parallel execution of notification handlers
• Fire-and-forget notifications
• Customizable exception handling

Installation

Install MediatR.ParallelPublisher via NuGet Package Manager or by running the following command:

dotnet add package MediatR.ParallelPublisher

Usage

After installing the package, register the parallel publisher in your dependency injection container:

services.AddMediatR(config => { config.UseParallelNotificationPublisher(options => { // Register custom exception handlers (optional) options.RegisterExceptionHandler<MyCustomExceptionHandler>(); }); });

To make a notification fire-and-forget, either implement the IFireAndForgetNotification interface or use the FireAndForgetNotificationAttribute:

// Using the IFireAndForgetNotification interface public class MyNotification : INotification, IFireAndForgetNotification { // ... } // Using the FireAndForgetNotificationAttribute [FireAndForgetNotification] public class MyOtherNotification : INotification { // ... }

Implement your notification handlers as usual, and they will be executed in parallel or fire-and-forget mode, depending on the notification type:

public class MyNotificationHandler : INotificationHandler<MyNotification> { public Task Handle(MyNotification notification, CancellationToken cancellationToken) { // Your handler implementation } }

For custom exception handling, implement the INotificationExceptionHandler interface:

public class MyCustomExceptionHandler : INotificationExceptionHandler { public Task HandleAsync(INotification notification, NotificationException exception) { // Handle the exception for the specified notification } }

License

MediatR.ParallelPublisher is released under the Apache License. See the LICENSE file for details.

Contributing

Contributions are welcome! Feel free to submit issues, feature requests, or pull requests.