LightMediator.EventBus.AzureServiceBus 0.5.1.12

LightMediator.EventBus.AzureServiceBus

LightMediator.EventBus.AzureServiceBus is an extension for LightMediator and LightMediator.EventBus that adds distributed messaging support using AzureServiceBus.

It enables publishing and subscribing to INotification messages between services, applications, or domains in a decoupled and scalable way — powered by AzureServiceBus and your high-performance, lightweight mediator.

✨ Features

• 🔄 Publish/Subscribe using Topic/Queue model over AzureServiceBus.
• 💡 Built on top of LightMediator.EventBus.
• 🔌 Easy integration with minimal configuration.
• 🔒 Supports durable queues and automatic reconnects.

📦 Installation

Install via NuGet:

dotnet add package LightMediator.EventBus.AzureServiceBus

Or via the Package Manager:

Install-Package LightMediator.EventBus.AzureServiceBus

🚀 Getting Started

1. Register LightMediator with AzureServiceBus support

In your Program.cs or Startup.cs:

builder.Services.AddLightMediator(options =>
{
    options.IgnoreNamespaceInAssemblies = true;
    options.IgnoreNotificationDifferences = true;
    options.RegisterNotificationsByAssembly = true;
    options.RegisterRequestsByAssembly = true;

    options.Assemblies = new[]
    {
        Assembly.GetExecutingAssembly(),
        Lib1.GetServiceAssembly(),
        Lib2.GetServiceAssembly(),
        Service1.GetServiceAssembly()
    };

    options.AddLightMediatorEventBus(services)
           .UseAzureServiceBus(builder.Configuration.GetSection("AzureServiceBusSettings"));
});

2. Create a Notification

using LightMediator;

namespace WorkerService1.Events;

internal class TestEvent:INotification
{
    public string MyProperty { get; set; }
}

3. Handle the Notification in another service

using LightMediator;
using WorkerService2.Events;

namespace WorkerService2.EventHandlers;

internal class TestEventHandler : NotificationHandler<TestEvent>
{
    private readonly ILogger<TestEventHandler> _logger;

    public TestEventHandler(ILogger<TestEventHandler> logger)
    {
        _logger = logger;
    }

    public override Task Handle(TestEvent message, CancellationToken? cancellationToken)
    {
        _logger.LogInformation($"___________________Event recieved__________________ {message.MyProperty}");
        return Task.CompletedTask;
    }
}

4. Publish a Notification as a Event using eventbus extension method

 await _mediator.PublishEvent(new TestEvent() { MyProperty = "Hello"});

The message will be delivered to all services that registered the same Topic and are listening for that notification.

📝 License

This project is licensed under the MIT License.

Created with ❤️ by @omidmloo