Table of Contents

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

services IServiceCollection

The service collection.

configureOptions Action<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

builder IDispatchBuilder

The dispatch builder.

configureOptions Action<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:

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

builder IDispatchBuilder

The 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 builder is null.