DotNetBrightener.Plugins.EventPubSub 2024.0.11.10220

dotnet add package DotNetBrightener.Plugins.EventPubSub --version 2024.0.11.10220
NuGet\Install-Package DotNetBrightener.Plugins.EventPubSub -Version 2024.0.11.10220
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="DotNetBrightener.Plugins.EventPubSub" Version="2024.0.11.10220" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add DotNetBrightener.Plugins.EventPubSub --version 2024.0.11.10220
#r "nuget: DotNetBrightener.Plugins.EventPubSub, 2024.0.11.10220"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install DotNetBrightener.Plugins.EventPubSub as a Cake Addin
#addin nuget:?package=DotNetBrightener.Plugins.EventPubSub&version=2024.0.11.10220

// Install DotNetBrightener.Plugins.EventPubSub as a Cake Tool
#tool nuget:?package=DotNetBrightener.Plugins.EventPubSub&version=2024.0.11.10220

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 Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (8)

Showing the top 5 NuGet packages that depend on DotNetBrightener.Plugins.EventPubSub:

Package Downloads
DotNetBrightener.DataAccess.EF

Package Description

DotNetBrightener.SimpleUploadService

A Simple Upload API for ASP.NET Core Applications

DotNetBrightener.Plugins.EventPubSub.DependencyInjection

Package Description

DotNetBrightener.WebApp.CommonShared

Package Description

DotNetBrightener.Infrastructure.ApiKeyAuthentication

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2024.0.11.10220 132 4/11/2024
2024.0.11.10120 114 4/10/2024
2024.0.11.10119 108 4/10/2024
2024.0.11.10115 121 4/10/2024
2024.0.11.9914 137 4/8/2024
2024.0.11.9901 123 4/7/2024
2024.0.11.9823 127 4/7/2024
2024.0.11.9401 131 4/2/2024
2024.0.11.9301 117 4/1/2024
2024.0.11.9206 115 3/31/2024
2024.0.11.9205 109 3/31/2024
2024.0.11.8200 137 3/21/2024
2024.0.11.8122 103 3/21/2024
2024.0.11.8120 123 3/21/2024
2024.0.11.7320 167 3/13/2024
2024.0.11.7316 132 3/13/2024
2024.0.11.7310 120 3/13/2024
2024.0.11 126 3/13/2024
2024.0.10 144 3/3/2024
2024.0.9 143 2/27/2024
2024.0.8 180 2/1/2024
2024.0.7 130 1/26/2024
2024.0.6 123 1/25/2024
2024.0.5 122 1/24/2024
2024.0.4 119 1/24/2024
2024.0.3 132 1/22/2024
2024.0.2 181 1/10/2024
2024.0.1 137 1/9/2024
2024.0.1-alpha-3 111 1/9/2024
2024.0.1-alpha-2 101 1/9/2024
2024.0.1-alpha-1 136 1/3/2024
2024.0.0 167 12/26/2023
2023.0.27 214 12/21/2023
2023.0.26 173 12/21/2023
2023.0.25 235 12/11/2023
2023.0.24 223 12/8/2023
2023.0.23 187 12/6/2023
2023.0.21 247 12/4/2023
2023.0.20 243 11/27/2023
2023.0.19 178 11/20/2023
2023.0.18 218 10/25/2023
2023.0.17 267 10/22/2023
2023.0.16 247 10/16/2023
2023.0.16-alpha-1 138 10/16/2023
2023.0.15 205 10/14/2023
2023.0.14 180 10/14/2023
2023.0.13 165 10/14/2023
2023.0.12 192 10/14/2023
2023.0.11 177 10/10/2023
2023.0.10 195 10/9/2023
2023.0.9 300 8/16/2023
2023.0.8 243 8/15/2023
2023.0.8-alpha-2 310 5/31/2023
2023.0.7 263 5/12/2023
2023.0.6 291 5/10/2023
2023.0.5 268 5/7/2023
2023.0.4 296 4/22/2023
2023.0.3 329 4/19/2023
2023.0.2 324 4/6/2023
2023.0.1 349 3/13/2023
2022.11.0 410 11/21/2022
2022.10.2 318 11/21/2022
2022.10.0 1,595 10/15/2022
2022.9.0 486 9/5/2022
2021.10.1 466 10/17/2021
1.0.0 478 1/19/2021