DotNetBrightener.Plugins.EventPubSub
2025.0.1-rc-243301701
See the version list below for details.
dotnet add package DotNetBrightener.Plugins.EventPubSub --version 2025.0.1-rc-243301701
NuGet\Install-Package DotNetBrightener.Plugins.EventPubSub -Version 2025.0.1-rc-243301701
<PackageReference Include="DotNetBrightener.Plugins.EventPubSub" Version="2025.0.1-rc-243301701" />
paket add DotNetBrightener.Plugins.EventPubSub --version 2025.0.1-rc-243301701
#r "nuget: DotNetBrightener.Plugins.EventPubSub, 2025.0.1-rc-243301701"
// Install DotNetBrightener.Plugins.EventPubSub as a Cake Addin #addin nuget:?package=DotNetBrightener.Plugins.EventPubSub&version=2025.0.1-rc-243301701&prerelease // Install DotNetBrightener.Plugins.EventPubSub as a Cake Tool #tool nuget:?package=DotNetBrightener.Plugins.EventPubSub&version=2025.0.1-rc-243301701&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
- DotNetBrightener.Plugins.EventPubSub.Abstractions (>= 2025.0.1-rc-243301701)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 9.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.0)
NuGet packages (14)
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.