Upgrading Polly 7 to 8
Breaking7.2.4 → 8.9.1Breaking43New79Changed103Fixed53Other709
BreakingUpgrade verdict
43 breaking changes.
In plain terms
- Renames BehaviorAction to BehaviorGenerator.
- Changes IResilienceStrategy from an interface to an abstract class, which affects how it is implemented.
- Cleans up the namespaces.
- Drops Task-based execute methods.
Must act Top 3 of 43 that need code or config changes
Polly publishes an official migration guide for version 8. It covers more than the release notes do.
Migration guide from Polly v7 to v8 ↗Target frameworks requirement changed in 8.9.0: .NETFramework4.6.1, .NETFramework4.7.2, .NETStandard1.1, .NETStandard2.0 → .NETFramework4.6.2, .NETFramework4.7.2, .NETStandard2.0, net10.0, net6.0, net8.0.
Adds polly.core 8.9.1.
Drops netstandard.library, system.valuetuple.
What you must change
Breaking43
Renames BehaviorAction to BehaviorGenerator.
BehaviorActionBehaviorGeneratorMakes IResilienceStrategy an abstract class instead of an interface.
IResilienceStrategyCleans up the namespaces.
Drops Task-based execute methods.
Changes the retry backoff type default to constant.
Renames ResilienceStrategyBuilder to CompositeStrategyBuilder.
ResilienceStrategyBuilderCompositeStrategyBuilderRenames ResilienceStrategy to ResiliencePipeline.
ResilienceStrategyResiliencePipelineDrops DelegatingResilienceStrategy.
DelegatingResilienceStrategyDrops ResilienceStrategyBuilderOptions.
ResilienceStrategyBuilderOptionsAdds Async suffix to some APIs.
Makes ResilienceStrategyOptions abstract.
ResilienceStrategyOptionsHides the non-generic Hedging and Fallback API.
HedgingFallbackUses delegates in TimeoutStrategyOptions and RateLimiterStrategyOptions.
TimeoutStrategyOptionsRateLimiterStrategyOptionsUses delegates in circuit breaker options.
Uses delegates in RetryStrategyOptions.
RetryStrategyOptionsUses delegates in HedgingStrategyOptions.
HedgingStrategyOptionsUses delegates in FallbackStrategyOptions.
FallbackStrategyOptionsDrops the callback API.
Drops Outcome and cleans up the options.
OutcomeRenames AddResilienceStrategy to AddResilienceStrategyRegistry.
AddResilienceStrategyAddResilienceStrategyRegistryConverts records to classes.
Drops the simple circuit breaker.
Renames Attempt to AttemptNumber.
AttemptAttemptNumberDrops the Extensions suffix from the Polly.Extensions namespace.
Polly.ExtensionsDrops ResilienceTelemetryFactory.
ResilienceTelemetryFactoryDrops internal visibility between assemblies.
Changes BuilderName and StrategyName to default to null.
BuilderNameStrategyNameDrops the Polly.Strategy namespace.
Polly.StrategyDrops some convenience extensions.
Renames TelemetryResilienceStrategyOptions to TelemetryOptions.
TelemetryResilienceStrategyOptionsTelemetryOptionsDrops custom validation attributes.
Drops TimeProvider.CancelAfter.
TimeProvider.CancelAfterRenames ExecuteCoreAsync to ExecuteCore.
ExecuteCoreAsyncExecuteCoreDrops the ResilienceStrategyBuilder.IsGenericBuilder property.
ResilienceStrategyBuilder.IsGenericBuilderRenames BuilderName to Name.
BuilderNameNameHides CircuitBreakerStateProvider.LastHandledOutcome.
CircuitBreakerStateProvider.LastHandledOutcomeDrops TelemetryResilienceStrategy.
TelemetryResilienceStrategyHides validation APIs.
Hides or drops some unused APIs.
Hides the IsSynchronous property.
IsSynchronousDrops unused ResiliencePipelineRegistry APIs.
ResiliencePipelineRegistryDrops the OutcomeArguments struct.
OutcomeArgumentsCleans up Outcome internals and drops unused hedging and fallbacks APIs.
OutcomeAPI changes
Generated by DepDelta from published .NET assemblies. Not mixed with prose notes.
- removed:
abstract class ExecutionRejectedException extends Exception - removed:
protected ctor ExecutionRejectedException() - removed:
protected ctor ExecutionRejectedException(SerializationInfo info, StreamingContext context) - removed:
protected ctor ExecutionRejectedException(string message) - removed:
protected ctor ExecutionRejectedException(string message, Exception inner) - added:
static class ResiliencePipelineConversionExtensions - added:
static method ResiliencePipelineConversionExtensions.AsAsyncPolicy(ResiliencePipeline strategy): IAsyncPolicy - added:
static method ResiliencePipelineConversionExtensions.AsAsyncPolicy<TResult>(ResiliencePipeline<TResult> strategy): IAsyncPolicy<TResult> - added:
static method ResiliencePipelineConversionExtensions.AsSyncPolicy(ResiliencePipeline strategy): ISyncPolicy - added:
static method ResiliencePipelineConversionExtensions.AsSyncPolicy<TResult>(ResiliencePipeline<TResult> strategy): ISyncPolicy<TResult>
- removed:
class BrokenCircuitException extends ExecutionRejectedException - removed:
class IsolatedCircuitException extends BrokenCircuitException - removed:
ctor BrokenCircuitException(string message) - removed:
ctor BrokenCircuitException(string message, Exception inner) - removed:
ctor IsolatedCircuitException(string message) - removed:
enum CircuitState - removed:
member CircuitState.Closed - removed:
member CircuitState.HalfOpen - removed:
member CircuitState.Isolated - removed:
member CircuitState.Open - removed:
protected ctor IsolatedCircuitException(SerializationInfo info, StreamingContext context) - changed:
ctor BrokenCircuitException() → ctor BrokenCircuitException(string message, Exception inner, TResult result)
- added:
ctor RateLimitRejectedException() - added:
ctor RateLimitRejectedException(string message) - added:
ctor RateLimitRejectedException(string message, Exception inner)
- removed:
class TimeoutRejectedException extends ExecutionRejectedException - removed:
ctor TimeoutRejectedException() - removed:
ctor TimeoutRejectedException(string message) - removed:
ctor TimeoutRejectedException(string message, Exception innerException) - removed:
protected ctor TimeoutRejectedException(SerializationInfo info, StreamingContext context)