LightBus

Lighbus

Lightbus هو تطبيق بسيط لإرسال الرسائل غير المتزامنة OneWay أو مع عودة لتطبيقات .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 CORE

إذا كنت تستخدم ASP.NET Core ، فما عليك سوى تثبيت LightBus.microsoft.dependencyInjection ، تمكنك هذه الحزمة من تسجيل معالج الرسائل تلقائيًا ، فقط باستخدام 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 ; }
}

MessageHandLerResponse

مثل الرسالة ، تحتاج فقط إلى فئة وتنفيذها: 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" ) ;
    }
}