Sidio.Functions.Worker.ServiceBus 1.2.0

Prefix Reserved
dotnet add package Sidio.Functions.Worker.ServiceBus --version 1.2.0                
NuGet\Install-Package Sidio.Functions.Worker.ServiceBus -Version 1.2.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Sidio.Functions.Worker.ServiceBus" Version="1.2.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Sidio.Functions.Worker.ServiceBus --version 1.2.0                
#r "nuget: Sidio.Functions.Worker.ServiceBus, 1.2.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Sidio.Functions.Worker.ServiceBus as a Cake Addin
#addin nuget:?package=Sidio.Functions.Worker.ServiceBus&version=1.2.0

// Install Sidio.Functions.Worker.ServiceBus as a Cake Tool
#tool nuget:?package=Sidio.Functions.Worker.ServiceBus&version=1.2.0                

Sidio.Functions.Worker.ServiceBus

A collection of useful service bus features for .NET isolated middleware.

build NuGet Version Coverage Status

Installation

Add the NuGet package to your project.

Middleware

Middleware template

The abstract class ServiceBusMiddlewareBase supports the following methods:

  • BeforeInvocationAsync: executed before the invocation of the FunctionExecutionDelegate.
  • AfterInvocationAsync: executed after the invocation of the FunctionExecutionDelegate, unless an exception is thrown.
  • AlwaysAfterInvocation: executed after the invocation of the FunctionExecutionDelegate, regardless of an exception being thrown.
  • OnExceptionAsync: executed when an exception is thrown during the invocation of the FunctionExecutionDelegate. Return true when the exception is handled, false when the exception should be rethrown.

ExceptionInsightMiddleware

The ExceptionInsightMiddleware adds exception details to a dead-lettered message:

  • Dead letter reason
  • Exception message

Please note: it is currently not possible to read the maximum delivery count setting of a queue or topic. Therefore, you have to configure the ExceptionInsightMiddlewareOptions manually and ensure the maximum delivery count is set to a value equal or less than the service bus setting.

Usage

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults(
        workerApplication =>
        {
            workerApplication.UseExceptionInsightMiddleware();
        })
    // ...

ScheduledRetryMiddleware

Usage

The ScheduledRetryMiddleware is an extension of the ExceptionInsightMiddleware, you should not register both middleware.

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults(
        workerApplication =>
        {
            workerApplication.UseScheduledRetryMiddleware();
        })
    // ...

Configuration

  • MaxDeliveryCount: the maximum number of delivery attempts before a message is dead-lettered.
  • BackoffMode: the backoff mode to use for rescheduling messages.
  • BackoffInSeconds: the number of seconds to wait before rescheduling a message.

Service Bus client provider

It's possible to use a custom IServiceBusClientProvider to provide a ServiceBusClient for sending messages:

services.AddScoped<IServiceBusClientProvider, MyServiceBusClientProvider>();

Manual dead-letter resubmission

When you want to resubmit a dead-lettered message manually, make sure the ScheduledRetryMiddleware.DeliveryAttempts property is removed.

Extensions

FunctionContext extensions

GetServiceBusTrigger

Gets the ServiceBusTriggerAttribute from the function context:

var attribute = functionContext.GetServiceBusTrigger();

IsServiceBusTrigger

Determines whether the function is a service bus trigger. Can be used when registering middleware:

functionsWorkerApplicationBuilder.UseWhen<MySerivceBusMiddleware>(context => context.IsServiceBusTrigger());

Known issues

  • The ExceptionInsightMiddleware and ScheduledRetryMiddleware only support a trigger with a ServiceBusRecievedMessage binding. A trigger-binding to a string is not supported.
Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.2.0 0 11/13/2024
1.1.6 88 10/14/2024
1.1.5 82 9/30/2024
1.1.4 133 8/12/2024
1.1.3 107 8/9/2024
1.1.2 64 7/31/2024
1.1.1 97 7/15/2024
1.1.0 142 6/21/2024
1.0.6 124 6/17/2024