LightBus

Lighbus

Lightbus是一个简单的实现，用于单方面发送异步消息或以.NET应用程序的返回。

安装

该库可通过Nuget软件包获得：

软件包管理器

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

.NET CLI

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

获取起动器

ASP.NET核心

如果您使用的是ASP.NET Core，只需安装lightbus.microsoft.ipendendenception，此软件包使您可以自动注册消息处理程序，只需使用下面的sintax即可。

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

创建消息和处理程序

信息

要创建消息非常简单，您只需要一个类并实现下面的IMessage接口

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

MessageHandler

像一条消息一样，您只需要一个课程和实现： IMessageHandler<TMessage> where TMessage: IMessage界面如下

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

发送消息

要触发一条消息，您需要注入ILightBus接口并使用PushAsync<TMessage>(TMessage)来派遣类似的消息

 [ 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" ;
    }
} 

通过响应创建消息和处理程序

消息响应

要创建消息非常简单，您只需要一个类并实现IMessage<out Response>接口如下

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

MessageHandleRsponse

像一条消息一样，您只需要一个类和实现： IMessageHandler<TMessage, TResponse> where TMessage: IMessage<TResponse>接口>接口如下

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

发送响应的消息

要触发一条消息，您需要注入ILightBus接口并使用Task<TResponse> SendAsync<TMessage, TResponse>(Action<TMessage> messageHandler = null)以派遣类似下面的消息

 [ 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" ) ;
    }
}