Brer 1.0.1

Brer

A rabbitMQ library for ASP.NET.

Special thanks to Marco Pil

• Brer
• How do i use Brer?
  • Initial Setup
  • Registering/Decorating an EventListener
  • Publishing events.
• I want to contribute!
• I'm missing a feature!

How do i use Brer?

Brer makes use of a hostedservice in ASP.NET.

A basic brer startup example can be found here.

Initial Setup

In short one must register the Brer services as follows:

services.UseBrer(
    new BrerOptionsBuilder().WithAddress(BrerOptionsBuilder.localHost, BrerOptionsBuilder.defaultPort)
        .WithPassword(BrerOptionsBuilder.defaultLogin)
        .WithUserName(BrerOptionsBuilder.defaultLogin)
        .WithExchange("MyExchange")
        .WithQueueName("MyQueue")
        .Build()
);

Brer can also be configured using environment variables as follows:

services.UseBrer(new BrerOptionsBuilder().ReadFromEnviromentVariables().Build());

Where it will look for the following variables:

• BrerHostName
• BrerPort
• BrerExchangeName
• BrerQueueName
• BrerUserName
• BrerPassword

Registering/Decorating an EventListener

Brer will automatically scan all referencing assemblies for EventListeners.

Once a class is annoted with the EventListener attribute it will further scan the class for Handlers.

NOTE: wildcards are currently not (officially) supported.

[EventListener]
public class MyEventHandler{

    [Handler(topic:"MyTopic")]
    public async Task Handle(MyEvent @event){
        // do stuff
    }

}

Publishing events.

To publish an event simply inject the IBrerPublisher into your class.

public class MyEventPublisher{

    private readonly IBrerPublisher _brerPublisher;

    MyEventPublisher(IBrerPublisher brerPublisher){
        _brerPublisher = brerPublisher;
    }

    PublishEvent(){
        _brerPublisher.Publish("MyTopic", MyEvent)
    }
}

I want to contribute!

As of now we'd greatly appreciate more Example projects & unit-testing of the library.

notes:

• No global usings
• Use SonarLint
• Rider/ReSharper default styling preferred

I'm missing a feature!

Simply open an issue