LightBus

Lighbus

A Lightbus é uma implementação simples para enviar mensagens assíncronas Oneway ou com retorno para aplicativos .NET.

Instalação

A biblioteca está disponível via Nuget Packages:

Gerente de pacotes

 Install-Package LightBus.Core
Install-Package LightBus.Microsoft.DependencyInjection

.NET CLI

dotnet add package LightBus.Core
dotnet add package LightBus.Microsoft.DependencyInjection

Obtendo iniciante

ASP.NET CORE

Se você estiver usando asp.net Core, basta instalar o Lightbus.microsoft.DependencyInjection, este pacote permite registrar automaticamente o manipulador de mensagens, apenas usando o Sintax abaixo.

 public void ConfigureServices ( IServiceCollection services )
{
    .. .
    services . AddLightBus ( ) ;
    .. .
} 

Criação de mensagens e manipuladores

Mensagem

Para criar uma mensagem é muito simples, você só precisa de uma aula e implementar a interface IMessage , como abaixo

 public class SampleMessage : IMessage
{
    public string Value { get ; set ; }
}

MessageHandler

Como uma mensagem, você só precisa de uma aula e implementar: IMessageHandler<TMessage> where TMessage: IMessage Interface, como abaixo

 public class SampleMessageHandler : IMessageHandler < SampleMessage >
{
    public Task HandleAsync ( SampleMessage message )
    {
        Debug . WriteLine ( message . Value ) ;
        return Task . CompletedTask ;
    }
}

Envio de mensagem

Para desencadear uma mensagem, você precisará injetar a interface ILightBus e usar PushAsync<TMessage>(TMessage) para despachar uma mensagem como abaixo

 [ Route ( "" ) ]
public class ValuesController : Controller
{
    private readonly ILightBus _lightBus ;

    public ValuesController ( ILightBus lightBus )
    {
        _lightBus = lightBus ;
    }

    [ HttpGet ]
    public async Task < string > Get ( )
    {
        await _lightBus . PushAsync (
            new SampleMessage { Value = "Hello LightBus" } ) ;

        return "Ok" ;
    }
} 

Criando mensagens e manipuladores com resposta

Resposta da mensagem

Para criar uma mensagem é muito simples, você só precisa de uma aula e implementar a interface IMessage<out Response> como abaixo

 public class SampleMessageResponse : IMessage < string >
{
    public string Value { get ; set ; }
}

MessageHandlerSponse

Como uma mensagem, você só precisa de uma aula e implementar: IMessageHandler<TMessage, TResponse> where TMessage: IMessage<TResponse> Interface como abaixo

 public class SampleMessageHandler : IMessageHandler < SampleMessageResponse , string >
{
    public Task < string > HandleAsync ( SampleMessageResponse message )
    {
        return Task . FromResult ( $ "Hello { message . Value } " ) ;
    }
}

Enviando mensagem com resposta

Para acionar uma mensagem, você precisará injetar a interface ILightBus e usar Task<TResponse> SendAsync<TMessage, TResponse>(Action<TMessage> messageHandler = null) para despachar uma mensagem como abaixo

 [ Route ( "" ) ]
public class ValuesController : Controller
{
    private readonly ILightBus _lightBus ;

    public ValuesController ( ILightBus lightBus )
    {
        _lightBus = lightBus ;
    }

    [ HttpGet ]
    public async Task < string > Get ( )
    {
        await _lightBus . SendAsync < SampleMessageResponse , string > ( msg => msg . Value = "LightBus" ) ;
    }
}