Franz.Common.Http.Messaging
3.0.0
dotnet add package Franz.Common.Http.Messaging --version 3.0.0
NuGet\Install-Package Franz.Common.Http.Messaging -Version 3.0.0
<PackageReference Include="Franz.Common.Http.Messaging" Version="3.0.0" />
<PackageVersion Include="Franz.Common.Http.Messaging" Version="3.0.0" />
<PackageReference Include="Franz.Common.Http.Messaging" />
paket add Franz.Common.Http.Messaging --version 3.0.0
#r "nuget: Franz.Common.Http.Messaging, 3.0.0"
#:package Franz.Common.Http.Messaging@3.0.0
#addin nuget:?package=Franz.Common.Http.Messaging&version=3.0.0
#tool nuget:?package=Franz.Common.Http.Messaging&version=3.0.0
Franz.Common.Http.Messaging
ASP.NET Core MVC integration for Kafka or RabbitMQ messaging transaction coordination and health checks.
Overview
ASP.NET Core MVC integration for Kafka or RabbitMQ messaging transaction coordination and health checks.
Installation
dotnet add package Franz.Common.Http.Messaging
RabbitMQ integration
The RabbitMQ extension is in Franz.Common.Http.Messaging.Extensions.
using Franz.Common.Http.Messaging.Extensions;
builder.Services.AddMessagingInHttpContext(builder.Configuration);
This composes RabbitMQ publisher, sender, and consumer registration through Franz.Common.Messaging.RabbitMQ, registers MessagingTransactionFilter, and adds the RabbitMQ connection health check. The filter is an MVC async action filter: after the action executes, it calls IMessagingTransaction.CompleteAsync() when no exception is present, or RollbackAsync() when an exception is present.
The filter coordinates an existing messaging transaction; it does not itself create a broker transaction or guarantee atomicity between an HTTP database transaction and a broker operation.
Kafka integration
Kafka has a separate extension class and entry point:
using Franz.Common.Http.Messaging;
builder.Services.AddKafkaMessagingInHttpContext(builder.Configuration);
This delegates producer/consumer setup to AddKafkaMessaging(configuration), registers the same MVC transaction filter, and adds a Kafka health check tagged messaging. The current health-check registration creates a default ConsumerConfig; supply and validate the actual broker configuration through the messaging package and test the health check against the target deployment.
Kafka and RabbitMQ registration are separate explicit calls. This package does not currently expose a single configuration-driven provider switch.
Manual registration
The package exposes separate methods for registering the messaging transaction filter and health checks. Use them only when composing those pieces manually; avoid duplicate registrations when the top-level extension has already been called.
Operational considerations
- Treat health checks as diagnostics, not proof that publish/consume workflows are correct.
- Configure broker credentials and TLS in the owning messaging package.
- Define retry, dead-letter, idempotency, and delivery semantics in the broker-specific messaging layer.
- Keep the HTTP request's success/failure semantics explicit. A filter completion callback is not a distributed transaction across arbitrary resources.
License
MIT. See LICENSE.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- AspNetCore.HealthChecks.AzureServiceBus (>= 9.0.0)
- AspNetCore.HealthChecks.Rabbitmq (>= 9.0.0)
- Franz.Common.Messaging (>= 3.0.0)
- Franz.Common.Messaging.Hosting.Kafka (>= 3.0.0)
- Franz.Common.Messaging.Identity (>= 3.0.0)
- Franz.Common.Messaging.MultiTenancy (>= 3.0.0)
- Franz.Common.Messaging.RabbitMQ (>= 3.0.0)
- Snappier (>= 1.3.1)
- System.Security.Cryptography.Pkcs (>= 10.0.13)
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 |
|---|---|---|
| 3.0.0 | 61 | 11/10/2026 |
| 2.3.4 | 336 | 11/1/2026 |
| 2.3.3 | 93 | 10/28/2026 |
| 2.3.2 | 104 | 10/27/2026 |
| 2.3.1 | 98 | 10/26/2026 |
| 2.3.0 | 150 | 7/21/2026 |
| 2.2.19 | 127 | 7/19/2026 |
| 2.2.18 | 122 | 7/19/2026 |
| 2.2.17 | 132 | 7/12/2026 |
| 2.2.16 | 134 | 7/2/2026 |
| 2.2.15 | 122 | 6/29/2026 |
| 2.2.14 | 131 | 6/29/2026 |
| 2.2.13 | 133 | 6/29/2026 |
| 2.2.12 | 121 | 6/28/2026 |
| 2.2.11 | 123 | 6/28/2026 |
| 2.2.10 | 130 | 6/28/2026 |
| 2.2.9 | 123 | 6/28/2026 |
| 2.2.8 | 125 | 6/28/2026 |
| 2.2.7 | 130 | 6/7/2026 |
| 2.2.6 | 135 | 6/6/2026 |