AugusteVN.Azure.ServiceBus 1.0.6

Azure Service Bus

Publishing messages to- & receiving messages from the Azure Service Bus.

This package contains wrapper- & helper functions for the official Azure.Messaging.ServiceBus NuGet package.

Contains:

• SenderClient to send a message to a topic.
• ReceiverClient to receive messages from a topic subscription.

Configuration

appsettings.json

{
  "ServiceBusConfig": {
    "ConnectionString": "<to-fill>",
    "QueueOrTopicNames": "<optional-fill-for-convenience>",
    "SubscriptionNames": "<optional-for-convenience>"
  }
}

Program.cs

builder.Services
    .AddOptions<ServiceBusConfig>()
    .BindConfiguration(nameof(ServiceBusConfig));

services.AddSingleton<ISenderClient, SenderClient>();
services.AddSingleton<IReceiverClient, ReceiverClient>();

// Or initialize an instance of either.

var sender = new SenderClient(
    new ServiceBusConfig {
        ConnectionString = "<to-fill>",
        QueueOrTopicNames = null
    });

var receiver = new ReceiverClient(
    new ServiceBusConfig {
        ConnectionString = "<to-fill>",
        QueueOrTopicNames = null,
        SubscriptionNames = null
    });

Send Message

Program.cs

app.MapPost("/", async (ISenderClient sender) => {
    
    var data = new { Foo = "bar" };
    var customProperties = new Dictionary<string, object> {{ "foo", "bar" }};
    
    await sender.SendAsync(
        queueOrTopicName: "<to-fill>",
        data,
        customProperties);
    
    // Or use the overload and construct your own 'ServiceBusMessage'.
    // Set 'queueOrTopicName' if not set in appSettings.json.
    await sender.SendAsync(
        queueOrTopicName: "<to-fill>"
        new ServiceBusMessage(body: data) {
            CorrelationId = "",
            ApplicationProperties = customProperties,
            ...
        }
    );
    
    return Results.NoContent();
});

Receive Message

Program.cs

app.MapPost("/", async (IReceiverClient receiver) => {
    
    var message = await receiver.ReceiveMessageAsync(
        queueOrTopicName: "<to-fill>",
        subscriptionName: null,
        maxWaitTime: TimeSpan.FromMinutes(5));
    
    if (message != null) {
        await receiver.CompleteMessageAsync(
            message,
            queueOrTopicName: "<to-fill>",
            subscriptionName: null);
    }
    
    return Results.NoContent();
});

Receive Multiple Messages

Program.cs

app.MapPost("/", async (IReceiverClient receiver) => {
    
    var messages = await receiver.ReceiveMessagesAsync(
        queueOrTopicName: "<to-fill>",
        subscriptionName: null,
        maxMessages: 300,
        maxWaitTime: TimeSpan.FromMinutes(5));
    
    foreach(var message in messages) {
        var isWantedMessage = message.ApplicationProperties["foo"]?.ToString() == "bar";
        if (!isWantedMessage) continue;

        var messageBody = receiver.ParseMessageBody<object>(message);
        
        ...
        
        var isSuccess = await DoStuff(messageBody);
        if (!isSuccess) continue;
            
        await receiver.CompleteMessageAsync(
            message,
            queueOrTopicName: "<to-fill>",
            subscriptionName: null);    
    }
    
    return Results.NoContent();
});

To see it in action, watch: Azure Service Bus Messaging in C# .NET