https://github.com/jonytek/azure-simple-servicebus
A basic generic wrapper around Azure ServiceBus.
https://github.com/jonytek/azure-simple-servicebus
azure azure-service-bus bus handler messaging microservice microservices queues service-bus
Last synced: 2 months ago
JSON representation
A basic generic wrapper around Azure ServiceBus.
- Host: GitHub
- URL: https://github.com/jonytek/azure-simple-servicebus
- Owner: JonyTek
- License: gpl-3.0
- Created: 2018-06-21T21:55:50.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-06-24T11:26:03.000Z (over 7 years ago)
- Last Synced: 2025-06-30T06:43:27.014Z (3 months ago)
- Topics: azure, azure-service-bus, bus, handler, messaging, microservice, microservices, queues, service-bus
- Language: C#
- Size: 30.3 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Simple Service Bus is a simple generic wrapper around Azures Message Bus. It provides a simple typed interface and allows you to write clean simple handlers with minimal configuration.
Simply setup your send bus
```csharp
//Setup routing
var routes = new MessageRouteTable()
.AddRoute("my-message-queue")
.AddRoute("my-message-topic");
//Initialise your bus
//Easily wire in to your IOC
ISendOnlyBus bus = new SendOnlyBus(new BusConfigutration(), routes);
//Send those messages!
await bus.Send(new MyQueueMessage { SomeString = "From my queue!" });
await bus.Publish(new MyTopicMessage { SomeString = "From my topic!" });
```
Simply setup your receive bus
```csharp
//Basic endpoint configuration
var defaultHandlerConfig = new HandlerConfiguration
{
MaxConcurrentCalls = 10,
AutoComplete = true
};
//Initialise your receive bus
IRecieveOnlyBus bus = RecieveOnlyBus.Initialise(new BusConfigutration())
.WithDependencyRegistrations(x =>
{
//Register your handlers
x.RegisterQueueHandler();
x.RegisterTopicHandler();
})
//Where do you want messages to go?
.RegisterQueue("my-message-queue", defaultHandlerConfig)
.RegisterTopic("my-message-topic", defaultHandlerConfig);
//On end
bus.Dispose();
```
Create some messages
```csharp
//Queue
public class MyQueueMessage : IQueueMessage
{
public string SomeString { get; set; }
public DateTime When { get; set; } = DateTime.UtcNow;
}
//Topic
public class MyTopicMessage : ITopicMessage
{
public string SomeString { get; set; }
public DateTime When { get; set; } = DateTime.UtcNow;
}
```
And create your handlers
```csharp
//Queue
public class MyMessageQueueMessageHandler : AbstractQueueMessageHandler
{
//Handler impl
public override Task Handle(MessageContext messageContext, CancellationToken token)
{
Console.WriteLine("MyMessageQueueMessageHandle " + messageContext.Message.SomeString);
return Task.FromResult(0);
}
//Optional OnException handler
public override Task OnException(ExceptionReceivedEventArgs exceptionReceivedEventArgs)
{
Console.WriteLine($"Exception: {exceptionReceivedEventArgs.Exception.Message}");
Console.WriteLine($"Action: {exceptionReceivedEventArgs.ExceptionReceivedContext.Action}");
Console.WriteLine($"ClientId: {exceptionReceivedEventArgs.ExceptionReceivedContext.ClientId}");
Console.WriteLine($"Endpoint: {exceptionReceivedEventArgs.ExceptionReceivedContext.Endpoint}");
Console.WriteLine($"EntityPath: {exceptionReceivedEventArgs.ExceptionReceivedContext.EntityPath}");
return base.OnException(exceptionReceivedEventArgs);
}
}
//Topic
public class MyMessageTopicMessageHandler : AbstractTopicMessageHandler
{
private readonly ISendOnlyBus bus;
public override string Subscription => "my-subscription";
//ISendOnlyBus is auto wired up with the IOC
public MyMessageTopicMessageHandler(ISendOnlyBus bus)
{
this.bus = bus;
}
//Handler impl
public override async Task Handle(MessageContext messageContext, CancellationToken token)
{
Console.WriteLine("MyMessageTopicMessageHandle " + messageContext.Message.SomeString);
await bus.Send(new MyQueueMessage {SomeString = " Resent!!"});
}
//Optional OnException handler
public override Task OnException(ExceptionReceivedEventArgs exceptionReceivedEventArgs)
{
Console.WriteLine($"Exception: {exceptionReceivedEventArgs.Exception.Message}");
Console.WriteLine($"Action: {exceptionReceivedEventArgs.ExceptionReceivedContext.Action}");
Console.WriteLine($"ClientId: {exceptionReceivedEventArgs.ExceptionReceivedContext.ClientId}");
Console.WriteLine($"Endpoint: {exceptionReceivedEventArgs.ExceptionReceivedContext.Endpoint}");
Console.WriteLine($"EntityPath: {exceptionReceivedEventArgs.ExceptionReceivedContext.EntityPath}");
return base.OnException(exceptionReceivedEventArgs);
}
}
```
Eezy Peezy!!