DotNetBrightener.Plugins.EventPubSub.Abstractions
                               
                            
                                2025.0.6-preview-317
                            
                        
                    See the version list below for details.
dotnet add package DotNetBrightener.Plugins.EventPubSub.Abstractions --version 2025.0.6-preview-317
NuGet\Install-Package DotNetBrightener.Plugins.EventPubSub.Abstractions -Version 2025.0.6-preview-317
<PackageReference Include="DotNetBrightener.Plugins.EventPubSub.Abstractions" Version="2025.0.6-preview-317" />
<PackageVersion Include="DotNetBrightener.Plugins.EventPubSub.Abstractions" Version="2025.0.6-preview-317" />
<PackageReference Include="DotNetBrightener.Plugins.EventPubSub.Abstractions" />
paket add DotNetBrightener.Plugins.EventPubSub.Abstractions --version 2025.0.6-preview-317
#r "nuget: DotNetBrightener.Plugins.EventPubSub.Abstractions, 2025.0.6-preview-317"
#:package DotNetBrightener.Plugins.EventPubSub.Abstractions@2025.0.6-preview-317
#addin nuget:?package=DotNetBrightener.Plugins.EventPubSub.Abstractions&version=2025.0.6-preview-317&prerelease
#tool nuget:?package=DotNetBrightener.Plugins.EventPubSub.Abstractions&version=2025.0.6-preview-317&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- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.7)
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.7)
- Microsoft.Testing.Platform (>= 1.7.3)
- Newtonsoft.Json (>= 13.0.3)
 
NuGet packages (2)
Showing the top 2 NuGet packages that depend on DotNetBrightener.Plugins.EventPubSub.Abstractions:
| Package | Downloads | 
|---|---|
| DotNetBrightener.Plugins.EventPubSub An event publisher / subscriber library for .Net Core Application | |
| DotNetBrightener.DataAccess.Abstractions.Models Package Description | 
GitHub repositories
This package is not used by any popular GitHub repositories.