DotNetBrightener.Plugins.EventPubSub
                              
                            
                                2025.0.6-preview-327
                            
                        
                    See the version list below for details.
dotnet add package DotNetBrightener.Plugins.EventPubSub --version 2025.0.6-preview-327
NuGet\Install-Package DotNetBrightener.Plugins.EventPubSub -Version 2025.0.6-preview-327
<PackageReference Include="DotNetBrightener.Plugins.EventPubSub" Version="2025.0.6-preview-327" />
<PackageVersion Include="DotNetBrightener.Plugins.EventPubSub" Version="2025.0.6-preview-327" />
<PackageReference Include="DotNetBrightener.Plugins.EventPubSub" />
paket add DotNetBrightener.Plugins.EventPubSub --version 2025.0.6-preview-327
#r "nuget: DotNetBrightener.Plugins.EventPubSub, 2025.0.6-preview-327"
#:package DotNetBrightener.Plugins.EventPubSub@2025.0.6-preview-327
#addin nuget:?package=DotNetBrightener.Plugins.EventPubSub&version=2025.0.6-preview-327&prerelease
#tool nuget:?package=DotNetBrightener.Plugins.EventPubSub&version=2025.0.6-preview-327&prerelease
Event Publish/Subscribe Library
© DotNet Brightener
Usage
Event message
Event message is a message that would be emitted by the IEventPublisher. The IEventHandler for the message will be proceeded sequentially, and will be stopped if the higher-prioritized handler tells the next one to stop by returning false in its HandleEvent method.
public class YourEventMessage: IEventMessage 
{
	// your model goes here
}
Non-Stopped event message
Non-stopped event message is the type of IEventMessage that will be handled by all the handlers regardless the result from the process of each handler.
public class YourEventMessage: INonStoppedEventMessage 
{
	// your model goes here
}
Define event handler
Define an event handler to process the event emitted by the IEventPublisher service as follow:
public class YourEventModelEventHandler: IEventHandler<YourEventMessage>
{
	// the higher number will tell the publisher to execute before the others
	public int Priority { get; } => 10;
	public async Task<bool> HandleEvent(YourEventMessage eventMessage) 
	{
		// do something with your eventMessage
		// if YourEventModel implements INonStoppedEventMessage, 
		// regardless the next statement, 
		// the next handler will continue to process in parallel
		// if you want to let the next handler to process the message
		return true;
		// otherwise, return false here;
		// return false;
	}
}
Emit the event
Inject IEventPublisher to your controller / service class and use it as follow:
public class SomeService 
{
	private readonly IEventPublisher _eventPublisher;
	// other services
	public SomeService(IEventPublisher eventPublisher, 
						// other services
						)
	{
		_eventPublisher = eventPublisher;
	}
	public async Task SomeMethod() 
	{
		var eventMessage = new YourEventMessage
		{
			// the event content
		};
		// if you want to let the event message to be processed in the current thread
		await _eventPublisher.Publish(eventMessage);
		// if you want to let the event message to be processed in the another thread
		await _eventPublisher.Publish(eventMessage, true);
	}
}
Register at startup
You will need to install the package DotNetBrightener.Plugins.EventPubSub.DependencyInjection from nuget.org and follow instruction there.
| Product | Versions Compatible and additional computed target framework versions. | 
|---|---|
| .NET | net9.0 is compatible. 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 was computed. 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. | 
- 
                                                    net9.0- DotNetBrightener.Plugins.EventPubSub.Abstractions (>= 2025.0.6-preview-327)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.7)
- Microsoft.Extensions.Hosting.Abstractions (>= 9.0.7)
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.7)
 
NuGet packages (10)
Showing the top 5 NuGet packages that depend on DotNetBrightener.Plugins.EventPubSub:
| Package | Downloads | 
|---|---|
| DotNetBrightener.Core.BackgroundTasks Package Description | |
| DotNetBrightener.Plugins.EventPubSub.DependencyInjection Package Description | |
| DotNetBrightener.SimpleUploadService A Simple Upload API for ASP.NET Core Applications | |
| DotNetBrightener.WebApp.CommonShared Package Description | |
| DotNetBrightener.Infrastructure.ApiKeyAuthentication Package Description | 
GitHub repositories
This package is not used by any popular GitHub repositories.