Class DispatchBuilderResilienceExtensions
- Namespace
- Microsoft.Extensions.DependencyInjection
- Assembly
- Excalibur.Dispatch.Resilience.Polly.dll
Extension methods for adding resilience to IDispatchBuilder.
public static class DispatchBuilderResilienceExtensions
- Inheritance
-
DispatchBuilderResilienceExtensions
- Inherited Members
Methods
AddPollyResilienceAdapters(IServiceCollection, Action<PollyResilienceAdapterOptions>?)
Adds Polly-based adapters for all resilience interfaces to the service collection.
public static IServiceCollection AddPollyResilienceAdapters(this IServiceCollection services, Action<PollyResilienceAdapterOptions>? configureOptions = null)
Parameters
servicesIServiceCollectionThe service collection.
configureOptionsAction<PollyResilienceAdapterOptions>Optional action to configure Polly resilience options.
Returns
- IServiceCollection
The service collection for method chaining.
UsePollyResilienceAdapters(IDispatchBuilder, Action<PollyResilienceAdapterOptions>?)
Adds Polly-based adapters for all resilience interfaces.
public static IDispatchBuilder UsePollyResilienceAdapters(this IDispatchBuilder builder, Action<PollyResilienceAdapterOptions>? configureOptions = null)
Parameters
builderIDispatchBuilderThe dispatch builder.
configureOptionsAction<PollyResilienceAdapterOptions>Optional action to configure Polly resilience options.
Returns
- IDispatchBuilder
The dispatch builder for method chaining.
Remarks
This method cleanly replaces all default resilience implementations with Polly-based adapters:
- IRetryPolicy → PollyRetryPolicyAdapter
- ICircuitBreakerPolicy → PollyCircuitBreakerPolicyAdapter
- IBackoffCalculator → Excalibur.Dispatch.Resilience.Polly.PollyBackoffCalculatorAdapter
- ITransportCircuitBreakerRegistry → PollyTransportCircuitBreakerRegistry
Consumers who want to use Polly's advanced features (decorrelated jitter, advanced circuit breaker strategies, telemetry hooks) can call this method to opt-in to Polly implementations.
UseResilience(IDispatchBuilder)
Adds Dispatch resilience (retry, circuit breaker, bulkhead, timeout) via the builder.
[RequiresUnreferencedCode("Configuration binding may reference types not preserved during trimming. Ensure resilience options models are annotated accordingly.")]
[RequiresDynamicCode("Configuration binding for resilience settings requires dynamic code generation for property reflection and value conversion.")]
public static IDispatchBuilder UseResilience(this IDispatchBuilder builder)
Parameters
builderIDispatchBuilderThe dispatch builder.
Returns
- IDispatchBuilder
The builder for fluent chaining.
Remarks
Register named policies through their subsystem configuration, then resolve and execute them at the dependency boundary. Registering services does not install retry middleware:
services.AddDispatch(dispatch => dispatch.UseResilience());
services.AddPollyRetryPolicy("orders", o => o.MaxRetryAttempts = 3);
services.AddPollyCircuitBreaker("orders-circuit", o => o.MinimumThroughput = 5);
Exceptions
- ArgumentNullException
Thrown when
builderis null.