Escendit.Orleans.Clients.RabbitMQ.AmqpProtocol 0.1.0-rc.146

NuGet Package: Escendit.Orleans.Clients.RabbitMQ.AmqpProtocol

Escendit.Orleans.Clients.RabbitMQ.AmqpProtocol is a NuGet package that provides the ability to register IConnectionFactory or IConnection. This package is suitable for both Worker (Console) and Web Applications, allowing you to easily configure and manage RabbitMQ connections within your Orleans-based projects.

Installation

To install Escendit.Orleans.Clients.RabbitMQ.AmqpProtocol, run the following command in the Package Manager Console:

Install-Package Escendit.Orleans.Clients.RabbitMQ.AmqpProtocol

Usage

There are several ways to register contracts that can be used in an application:

Host

Register and use IConnectionFactory with the newly named ConnectionOptions registration.

Host
    .CreateDefaultBuilder()
    .AddRabbitMqConnectionFactory("name", ...)

var connectionOptions = serviceProvider.GetRequiredServiceByName<IConnectionFactory>("name");

Register and use IConnectionFactory with the existing ConnectionOptions registration.

Host
    .CreateDefaultBuilder()
    .AddRabbitMqConnectionFactoryFromOption("name", "existing_name")

var connectionOptions = serviceProvider.GetRequiredServiceByName<IConnectionFactory>("name");

Register and use IConnection with the newly named ConnectionOptions and IConnectionFactory registration.

Host
    .CreateDefaultBuilder()
    .AddRabbitMqConnection("name", ...)

var connectionOptions = serviceProvider.GetRequiredServiceByName<IConnection>("name");

Register and use IConnection with the existing IConnectionFactory registration.

Host
    .CreateDefaultBuilder()
    .AddRabbitMqConnectionFromFactory("name", "existing_name")

var connectionOptions = serviceProvider.GetRequiredServiceByName<IConnection>("name");

Web Application

Register and use IConnectionFactory with the newly named ConnectionOptions registration.

WebApplication
    .CreateBuilder()
    .AddRabbitMqConnectionFactory("name", ...)

var connectionOptions = serviceProvider.GetRequiredServiceByName<IConnectionFactory>("name");

Register and use IConnectionFactory with the existing ConnectionOptions registration.

WebApplication
    .CreateBuilder()
    .AddRabbitMqConnectionFactoryFromOption("name", "existing_name")

var connectionOptions = serviceProvider.GetRequiredServiceByName<IConnectionFactory>("name");

Register and use IConnection with the newly named ConnectionOptions and IConnectionFactory registration.

WebApplication
    .CreateBuilder()
    .AddRabbitMqConnection("name", ...)

var connectionOptions = serviceProvider.GetRequiredServiceByName<IConnection>("name");

Register and use IConnection with the existing IConnectionFactory registration.

WebApplication
    .CreateBuilder()
    .AddRabbitMqConnectionFromFactory("name", "existing_name")

var connectionOptions = serviceProvider.GetRequiredServiceByName<IConnection>("name");

Contributing

If you'd like to contribute to Escendit.Orleans.Clients.RabbitMQ, please fork the repository and make changes as you'd like. Pull requests are warmly welcome.