LightMediator.EventBus.MQTT 0.5.2.3

LightMediator.EventBus.MQTT

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

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

✨ Features

• 🔄 Publish/Subscribe model over MQTT.
• 💡 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.MQTT

Or via the Package Manager:

Install-Package LightMediator.EventBus.MQTT

🚀 Getting Started

1. Register LightMediator with MQTT 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)
           .UseMQTT(builder.Configuration.GetSection("MQTTSettings"));
});

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 ExchangeName and are listening for that notification.

5. Publish a message to Extra topics

Subscribe:

    builder.Services.AddLightMediator(o =>
    {
        o.IgnoreNamespaceInAssemblies = true;
        o.IgnoreNotificationDifferences = true;
        o.RegisterNotificationsByAssembly = true;
        o.RegisterRequestsByAssembly = true;
        o.Assemblies = new[]
                {
                    Assembly.GetExecutingAssembly()
                };
        o.AddLightMediatorEventBus(builder.Services)
         .UseMQTT(builder.Configuration.GetSection("MQTTSettings"), mqtto => mqtto.AddTopics("pro","main"));
    });

Publish:

await _mediator.PublishEvent(new TestEvent() { MyProperty = "Hello"}, extraTopics: "pro");

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

📝 License

This project is licensed under the MIT License.

Created with ❤️ by @omidmloo