Amanhecer.Extensions.Resilience
2.0.0
dotnet add package Amanhecer.Extensions.Resilience --version 2.0.0
NuGet\Install-Package Amanhecer.Extensions.Resilience -Version 2.0.0
<PackageReference Include="Amanhecer.Extensions.Resilience" Version="2.0.0" />
<PackageVersion Include="Amanhecer.Extensions.Resilience" Version="2.0.0" />
<PackageReference Include="Amanhecer.Extensions.Resilience" />
paket add Amanhecer.Extensions.Resilience --version 2.0.0
#r "nuget: Amanhecer.Extensions.Resilience, 2.0.0"
#:package Amanhecer.Extensions.Resilience@2.0.0
#addin nuget:?package=Amanhecer.Extensions.Resilience&version=2.0.0
#tool nuget:?package=Amanhecer.Extensions.Resilience&version=2.0.0
Amanhecer.Extensions.Resilience
Resilience middleware for Amanhecer, a lightweight request dispatcher (mediator) for .NET, built on Microsoft.Extensions.Resilience. Execute the remainder of a request pipeline — including the handler — inside a named Polly resilience pipeline (retry, circuit breaker, timeout, fallback, hedging), with request metadata enrichment for Polly's telemetry.
Configuring resilience pipelines
Register named pipelines with the container:
services.AddResiliencePipeline("order-processing", builder => builder
.AddRetry(new RetryStrategyOptions
{
MaxRetryAttempts = 3,
Delay = TimeSpan.FromMilliseconds(200)
})
.AddTimeout(TimeSpan.FromSeconds(5)));
Fluent usage
Pass the pipeline name as the middleware metadata:
services.AddAmanhecer(a => a
.AddRequestHandler<PlaceOrderHandler>(cfg => cfg
.Use<ResiliencePipelineMiddleware>(order: 1, metadata: "order-processing")));
Attribute usage
[ResiliencePipeline("order-processing", order: 1)]
public class PlaceOrderHandler : RequestHandler<PlaceOrder> { ... }
Behaviour
- The dispatch's
CancellationTokenflows into the resilience execution, so cancelling a dispatch aborts retries, and a timeout strategy replaces the token seen by the rest of the pipeline. - A custom Polly
ResilienceContextcan be supplied per dispatch through the pipeline-context metadata, under the keyResiliencePipelineMiddleware.ResilienceContext.
Telemetry enrichment
The middleware enriches the execution with RequestMetadata carrying the request type name. Register the resilience enricher to include it (and exception summaries) in Polly's logs and metrics:
services.AddResilienceEnricher();
Want a thinner integration directly on Polly.Core? Use the Amanhecer.Polly package instead.
Documentation
Full documentation lives in the repository docs.
Licence
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. 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. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. 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. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 is compatible. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.6.2
- Amanhecer.Abstractions (>= 2.0.0)
- Microsoft.Extensions.Resilience (>= 10.10.0)
-
.NETStandard 2.0
- Amanhecer.Abstractions (>= 2.0.0)
- Microsoft.Extensions.Resilience (>= 10.10.0)
-
net10.0
- Amanhecer.Abstractions (>= 2.0.0)
- Microsoft.Extensions.Resilience (>= 10.10.0)
-
net8.0
- Amanhecer.Abstractions (>= 2.0.0)
- Microsoft.Extensions.Resilience (>= 8.10.0)
-
net9.0
- Amanhecer.Abstractions (>= 2.0.0)
- Microsoft.Extensions.Resilience (>= 9.10.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.