DotNetBrightener.Plugins.EventPubSub.RabbitMq 2024.0.14.6-preview-2430401

This is a prerelease version of DotNetBrightener.Plugins.EventPubSub.RabbitMq.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package DotNetBrightener.Plugins.EventPubSub.RabbitMq --version 2024.0.14.6-preview-2430401                
NuGet\Install-Package DotNetBrightener.Plugins.EventPubSub.RabbitMq -Version 2024.0.14.6-preview-2430401                
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.RabbitMq" Version="2024.0.14.6-preview-2430401" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add DotNetBrightener.Plugins.EventPubSub.RabbitMq --version 2024.0.14.6-preview-2430401                
#r "nuget: DotNetBrightener.Plugins.EventPubSub.RabbitMq, 2024.0.14.6-preview-2430401"                
#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.RabbitMq as a Cake Addin
#addin nuget:?package=DotNetBrightener.Plugins.EventPubSub.RabbitMq&version=2024.0.14.6-preview-2430401&prerelease

// Install DotNetBrightener.Plugins.EventPubSub.RabbitMq as a Cake Tool
#tool nuget:?package=DotNetBrightener.Plugins.EventPubSub.RabbitMq&version=2024.0.14.6-preview-2430401&prerelease                

RabbitMq Integration for Event PubSub Library

© 2024 DotNet Brightener

Versions

Library Version
EventPubSub Core NuGet Version
EventPubSub Distributed Library NuGet Version
Dependency Injection Library NuGet Version
Azure Service Bus Integration Library NuGet Version
RabbitMq Integration Library NuGet Version

Installation

dotnet package add DotNetBrightener.Plugins.EventPubSub
dotnet package add DotNetBrightener.Plugins.EventPubSub.DependencyInjection
dotnet package add DotNetBrightener.Plugins.EventPubSub.Distributed
dotnet package add DotNetBrightener.Plugins.EventPubSub.AzureServiceBus
# or 
dotnet add package DotNetBrightener.Plugins.EventPubSub.RabbitMq

Usage

Configuration

Option 1: Use IConfiguration to configure the service bus

// Initialize EventPubSubService
var eventPubSubConfig = builder.Services
                               .AddEventPubSubService()
                                // scan for event messages in the given assembly
                               .AddEventMessagesFromAssemblies(typeof(DistributedTestMessage).Assembly)
                                // scan for event handlers in the given assembly
                               .AddEventHandlersFromAssemblies(Assembly.GetExecutingAssembly());

// Add RabbitMq
eventPubSubConfig.UseRabbitMq(builder.Configuration)
                 .Finalize();

In your appsettings.json file, add the the following configuration:

  "RabbitMqConfiguration": {
    "Host": "<rabbit-mq-host>",
    "Username": "<rabbit-mq-username>",
    "Password": "<rabbit-mq-password>",
    "VirtualHost": "<rabbit-mq-virtual-host>",
    "SubscriptionName": "<application-name>",
    "IncludeNamespaceForTopicName": false
  }
Option 2: Configure from code

// Initialize EventPubSubService
var eventPubSubConfig = builder.Services
                               .AddEventPubSubService()
                                // scan for event messages in the given assembly
                               .AddEventMessagesFromAssemblies(Assembly.GetExecutingAssembly(), typeof(DistributedTestMessage).Assembly)
                                // scan for event handlers in the given assembly
                               .AddEventHandlersFromAssemblies(Assembly.GetExecutingAssembly());

var distributedIntegrations = eventPubSubConfig.EnableDistributedIntegrations();

distributedIntegrations.SetSubscriptionName("<application-name>");
// if you want to exclude namespace in entity name
distributedIntegrations.ExcludeNamespaceInEntityName();

// Add RabbitMq
distributedIntegrations.UseRabbitMq("<rabbit-mq-host>",
                                    "<rabbit-mq-username>",
                                    "<rabbit-mq-password>",
                                    "<rabbit-mq-virtual-host>");

// this should be called before builder.Build(), or before exiting ConfigureServices method
distributedIntegrations.Finalize();

Refer to the Event PubSub Library, MassTransit Integration Library for more details on how to configure the event messages, request/response messages and how to implement handlers for them.

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

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.