<PackageReference Include="Polly" Version="5.4.0" />

---

API Differences between 5.4.0 and 5.2.0

137 Additions 4 Removals

Polly

• public static class FallbackSyntax
  • public static FallbackPolicy Fallback(this PolicyBuilder policyBuilder, Action<Context> fallbackAction, Action<Exception, Context> onFallback)
  • public static FallbackPolicy Fallback(this PolicyBuilder policyBuilder, Action<Context, CancellationToken> fallbackAction, Action<Exception, Context> onFallback)
  • public static FallbackPolicy Fallback(this PolicyBuilder policyBuilder, Action<Exception, Context, CancellationToken> fallbackAction, Action<Exception, Context> onFallback)
• public static class FallbackSyntaxAsync
  • public static FallbackPolicy FallbackAsync(this PolicyBuilder policyBuilder, Func<Context, CancellationToken, Task> fallbackAction, Func<Exception, Context, Task> onFallbackAsync)
  • public static FallbackPolicy FallbackAsync(this PolicyBuilder policyBuilder, Func<Exception, Context, CancellationToken, Task> fallbackAction, Func<Exception, Context, Task> onFallbackAsync)
• public static class FallbackTResultSyntax
  • public static FallbackPolicy<TResult> Fallback<TResult>(this PolicyBuilder<TResult> policyBuilder, Func<Context, TResult> fallbackAction, Action<DelegateResult<TResult>, Context> onFallback)
  • public static FallbackPolicy<TResult> Fallback<TResult>(this PolicyBuilder<TResult> policyBuilder, Func<Context, CancellationToken, TResult> fallbackAction, Action<DelegateResult<TResult>, Context> onFallback)
  • public static FallbackPolicy<TResult> Fallback<TResult>(this PolicyBuilder<TResult> policyBuilder, Func<DelegateResult<TResult>, Context, CancellationToken, TResult> fallbackAction, Action<DelegateResult<TResult>, Context> onFallback)
• public static class FallbackTResultSyntaxAsync
  • public static FallbackPolicy<TResult> FallbackAsync<TResult>(this PolicyBuilder<TResult> policyBuilder, Func<Context, CancellationToken, Task<TResult>> fallbackAction, Func<DelegateResult<TResult>, Context, Task> onFallbackAsync)
  • public static FallbackPolicy<TResult> FallbackAsync<TResult>(this PolicyBuilder<TResult> policyBuilder, Func<DelegateResult<TResult>, Context, CancellationToken, Task<TResult>> fallbackAction, Func<DelegateResult<TResult>, Context, Task> onFallbackAsync)
• public interface ISyncPolicy<TResult> : IsPolicy
  • TResult Execute(Func<TResult> action)
  • TResult Execute(Func<Context, TResult> action, IDictionary<string, object> contextData)
  • TResult Execute(Func<Context, TResult> action, Context context)
  • TResult Execute(Func<CancellationToken, TResult> action, CancellationToken cancellationToken)
  • TResult Execute(Func<Context, CancellationToken, TResult> action, IDictionary<string, object> contextData, CancellationToken cancellationToken)
  • TResult Execute(Func<Context, CancellationToken, TResult> action, Context context, CancellationToken cancellationToken)
  • PolicyResult<TResult> ExecuteAndCapture(Func<TResult> action)
  • PolicyResult<TResult> ExecuteAndCapture(Func<Context, TResult> action, IDictionary<string, object> contextData)
  • PolicyResult<TResult> ExecuteAndCapture(Func<Context, TResult> action, Context context)
  • PolicyResult<TResult> ExecuteAndCapture(Func<CancellationToken, TResult> action, CancellationToken cancellationToken)
  • PolicyResult<TResult> ExecuteAndCapture(Func<Context, CancellationToken, TResult> action, IDictionary<string, object> contextData, CancellationToken cancellationToken)
  • PolicyResult<TResult> ExecuteAndCapture(Func<Context, CancellationToken, TResult> action, Context context, CancellationToken cancellationToken)
  • ISyncPolicy<TResult> WithPolicyKey(string policyKey)
• public abstract class Policy : ISyncPolicy, IsPolicy, IAsyncPolicy
  • public static CachePolicy Cache(ISyncCacheProvider cacheProvider, TimeSpan ttl, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy Cache(ISyncCacheProvider cacheProvider, ITtlStrategy ttlStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy Cache(ISyncCacheProvider cacheProvider, TimeSpan ttl, Func<Context, string> cacheKeyStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy Cache(ISyncCacheProvider cacheProvider, ITtlStrategy ttlStrategy, Func<Context, string> cacheKeyStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy Cache(ISyncCacheProvider cacheProvider, ITtlStrategy ttlStrategy, ICacheKeyStrategy cacheKeyStrategy, Action<Context, string> onCacheGet, Action<Context, string> onCacheMiss, Action<Context, string> onCachePut, Action<Context, string, Exception> onCacheGetError, Action<Context, string, Exception> onCachePutError)
  • public static CachePolicy Cache(ISyncCacheProvider cacheProvider, ITtlStrategy ttlStrategy, Func<Context, string> cacheKeyStrategy, Action<Context, string> onCacheGet, Action<Context, string> onCacheMiss, Action<Context, string> onCachePut, Action<Context, string, Exception> onCacheGetError, Action<Context, string, Exception> onCachePutError)
  • public static CachePolicy<TResult> Cache<TResult>(ISyncCacheProvider cacheProvider, TimeSpan ttl, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy<TResult> Cache<TResult>(ISyncCacheProvider cacheProvider, ITtlStrategy ttlStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy<TResult> Cache<TResult>(ISyncCacheProvider<TResult> cacheProvider, TimeSpan ttl, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy<TResult> Cache<TResult>(ISyncCacheProvider<TResult> cacheProvider, ITtlStrategy ttlStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy<TResult> Cache<TResult>(ISyncCacheProvider cacheProvider, TimeSpan ttl, Func<Context, string> cacheKeyStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy<TResult> Cache<TResult>(ISyncCacheProvider cacheProvider, ITtlStrategy ttlStrategy, Func<Context, string> cacheKeyStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy<TResult> Cache<TResult>(ISyncCacheProvider<TResult> cacheProvider, TimeSpan ttl, Func<Context, string> cacheKeyStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy<TResult> Cache<TResult>(ISyncCacheProvider<TResult> cacheProvider, ITtlStrategy ttlStrategy, Func<Context, string> cacheKeyStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy<TResult> Cache<TResult>(ISyncCacheProvider<TResult> cacheProvider, ITtlStrategy ttlStrategy, ICacheKeyStrategy cacheKeyStrategy, Action<Context, string> onCacheGet, Action<Context, string> onCacheMiss, Action<Context, string> onCachePut, Action<Context, string, Exception> onCacheGetError, Action<Context, string, Exception> onCachePutError)
  • public static CachePolicy<TResult> Cache<TResult>(ISyncCacheProvider<TResult> cacheProvider, ITtlStrategy ttlStrategy, Func<Context, string> cacheKeyStrategy, Action<Context, string> onCacheGet, Action<Context, string> onCacheMiss, Action<Context, string> onCachePut, Action<Context, string, Exception> onCacheGetError, Action<Context, string, Exception> onCachePutError)
  • public static CachePolicy CacheAsync(IAsyncCacheProvider cacheProvider, TimeSpan ttl, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy CacheAsync(IAsyncCacheProvider cacheProvider, ITtlStrategy ttlStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy CacheAsync(IAsyncCacheProvider cacheProvider, TimeSpan ttl, Func<Context, string> cacheKeyStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy CacheAsync(IAsyncCacheProvider cacheProvider, ITtlStrategy ttlStrategy, Func<Context, string> cacheKeyStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy CacheAsync(IAsyncCacheProvider cacheProvider, ITtlStrategy ttlStrategy, ICacheKeyStrategy cacheKeyStrategy, Action<Context, string> onCacheGet, Action<Context, string> onCacheMiss, Action<Context, string> onCachePut, Action<Context, string, Exception> onCacheGetError, Action<Context, string, Exception> onCachePutError)
  • public static CachePolicy CacheAsync(IAsyncCacheProvider cacheProvider, ITtlStrategy ttlStrategy, Func<Context, string> cacheKeyStrategy, Action<Context, string> onCacheGet, Action<Context, string> onCacheMiss, Action<Context, string> onCachePut, Action<Context, string, Exception> onCacheGetError, Action<Context, string, Exception> onCachePutError)
  • public static CachePolicy<TResult> CacheAsync<TResult>(IAsyncCacheProvider cacheProvider, TimeSpan ttl, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy<TResult> CacheAsync<TResult>(IAsyncCacheProvider cacheProvider, ITtlStrategy ttlStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy<TResult> CacheAsync<TResult>(IAsyncCacheProvider<TResult> cacheProvider, TimeSpan ttl, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy<TResult> CacheAsync<TResult>(IAsyncCacheProvider<TResult> cacheProvider, ITtlStrategy ttlStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy<TResult> CacheAsync<TResult>(IAsyncCacheProvider cacheProvider, TimeSpan ttl, Func<Context, string> cacheKeyStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy<TResult> CacheAsync<TResult>(IAsyncCacheProvider cacheProvider, ITtlStrategy ttlStrategy, Func<Context, string> cacheKeyStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy<TResult> CacheAsync<TResult>(IAsyncCacheProvider<TResult> cacheProvider, TimeSpan ttl, Func<Context, string> cacheKeyStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy<TResult> CacheAsync<TResult>(IAsyncCacheProvider<TResult> cacheProvider, ITtlStrategy ttlStrategy, Func<Context, string> cacheKeyStrategy, Action<Context, string, Exception> onCacheError = null)
  • public static CachePolicy<TResult> CacheAsync<TResult>(IAsyncCacheProvider<TResult> cacheProvider, ITtlStrategy ttlStrategy, ICacheKeyStrategy cacheKeyStrategy, Action<Context, string> onCacheGet, Action<Context, string> onCacheMiss, Action<Context, string> onCachePut, Action<Context, string, Exception> onCacheGetError, Action<Context, string, Exception> onCachePutError)
  • public static CachePolicy<TResult> CacheAsync<TResult>(IAsyncCacheProvider<TResult> cacheProvider, ITtlStrategy ttlStrategy, Func<Context, string> cacheKeyStrategy, Action<Context, string> onCacheGet, Action<Context, string> onCacheMiss, Action<Context, string> onCachePut, Action<Context, string, Exception> onCacheGetError, Action<Context, string, Exception> onCachePutError)
• public class PolicyResult
  • public static PolicyResult Failure(Exception exception, ExceptionType exceptionType, Context context)
  • public static PolicyResult Successful(Context context)
• public class PolicyResult<TResult>
  • public static PolicyResult<TResult> Failure(Exception exception, ExceptionType exceptionType, Context context)
  • public static PolicyResult<TResult> Failure(TResult handledResult, Context context)
  • public static PolicyResult<TResult> Successful(TResult result, Context context)

Polly.Caching

• public class AbsoluteTtl : NonSlidingTtl
  • public AbsoluteTtl(DateTimeOffset absoluteExpirationTime)
• public class CachePolicy : Policy
• public class CachePolicy<TResult> : Policy<TResult>
• public static class CacheProviderExtensions
  • public static IAsyncCacheProvider<TCacheFormat> AsyncFor<TCacheFormat>(this IAsyncCacheProvider nonGenericCacheProvider)
  • public static ISyncCacheProvider<TCacheFormat> For<TCacheFormat>(this ISyncCacheProvider nonGenericCacheProvider)
  • public static SerializingCacheProvider<TSerialized> WithSerializer<TSerialized>(this ISyncCacheProvider<TSerialized> cacheProvider, ICacheItemSerializer<object, TSerialized> serializer)
  • public static SerializingCacheProvider<TResult, TSerialized> WithSerializer<TResult, TSerialized>(this ISyncCacheProvider<TSerialized> cacheProvider, ICacheItemSerializer<TResult, TSerialized> serializer)
  • public static SerializingCacheProviderAsync<TSerialized> WithSerializer<TSerialized>(this IAsyncCacheProvider<TSerialized> cacheProvider, ICacheItemSerializer<object, TSerialized> serializer)
  • public static SerializingCacheProviderAsync<TResult, TSerialized> WithSerializer<TResult, TSerialized>(this IAsyncCacheProvider<TSerialized> cacheProvider, ICacheItemSerializer<TResult, TSerialized> serializer)
• public class ContextualTtl : ITtlStrategy
  • public static readonly string SlidingExpirationKey
  • public static readonly string TimeSpanKey
  • public ContextualTtl()
  • public Ttl GetTtl(Context context)
• public class DefaultCacheKeyStrategy : ICacheKeyStrategy
  • public static readonly ICacheKeyStrategy Instance
  • public DefaultCacheKeyStrategy()
  • public string GetCacheKey(Context context)
• public interface IAsyncCacheProvider
  • Task<object> GetAsync(string key, CancellationToken cancellationToken, bool continueOnCapturedContext)
  • Task PutAsync(string key, object value, Ttl ttl, CancellationToken cancellationToken, bool continueOnCapturedContext)
• public interface IAsyncCacheProvider<TResult>
  • Task<TResult> GetAsync(string key, CancellationToken cancellationToken, bool continueOnCapturedContext)
  • Task PutAsync(string key, TResult value, Ttl ttl, CancellationToken cancellationToken, bool continueOnCapturedContext)
• public interface ICacheItemSerializer<TResult, TSerialized>
  • TResult Deserialize(TSerialized objectToDeserialize)
  • TSerialized Serialize(TResult objectToSerialize)
• public interface ICacheKeyStrategy
  • string GetCacheKey(Context context)
• public interface ISyncCacheProvider
  • object Get(string key)
  • void Put(string key, object value, Ttl ttl)
• public interface ISyncCacheProvider<TResult>
  • TResult Get(string key)
  • void Put(string key, TResult value, Ttl ttl)
• public interface ITtlStrategy
  • Ttl GetTtl(Context context)
• public abstract class NonSlidingTtl : ITtlStrategy
  • protected readonly DateTimeOffset absoluteExpirationTime
  • protected NonSlidingTtl(DateTimeOffset absoluteExpirationTime)
  • public Ttl GetTtl(Context context)
• public class RelativeTtl : NonSlidingTtl
  • public RelativeTtl(TimeSpan ttl)
• public class SerializingCacheProvider<TSerialized> : ISyncCacheProvider
  • public SerializingCacheProvider(ISyncCacheProvider<TSerialized> wrappedCacheProvider, ICacheItemSerializer<object, TSerialized> serializer)
  • public object Get(string key)
  • public void Put(string key, object value, Ttl ttl)
• public class SerializingCacheProvider<TResult, TSerialized> : ISyncCacheProvider<TResult>
  • public SerializingCacheProvider(ISyncCacheProvider<TSerialized> wrappedCacheProvider, ICacheItemSerializer<TResult, TSerialized> serializer)
  • public TResult Get(string key)
  • public void Put(string key, TResult value, Ttl ttl)
• public class SerializingCacheProviderAsync<TSerialized> : IAsyncCacheProvider
  • public SerializingCacheProviderAsync(IAsyncCacheProvider<TSerialized> wrappedCacheProvider, ICacheItemSerializer<object, TSerialized> serializer)
  • public Task<object> GetAsync(string key, CancellationToken cancellationToken, bool continueOnCapturedContext)
  • public Task PutAsync(string key, object value, Ttl ttl, CancellationToken cancellationToken, bool continueOnCapturedContext)
• public class SerializingCacheProviderAsync<TResult, TSerialized> : IAsyncCacheProvider<TResult>
  • public SerializingCacheProviderAsync(IAsyncCacheProvider<TSerialized> wrappedCacheProvider, ICacheItemSerializer<TResult, TSerialized> serializer)
  • public Task<TResult> GetAsync(string key, CancellationToken cancellationToken, bool continueOnCapturedContext)
  • public Task PutAsync(string key, TResult value, Ttl ttl, CancellationToken cancellationToken, bool continueOnCapturedContext)
• public class SlidingTtl : ITtlStrategy
  • public SlidingTtl(TimeSpan slidingTtl)
  • public Ttl GetTtl(Context context)
• public struct Ttl
  • public bool SlidingExpiration
  • public TimeSpan Timespan
  • public Ttl(TimeSpan timeSpan)
  • public Ttl(TimeSpan timeSpan, bool slidingExpiration)

Polly.Registry

• public interface IPolicyRegistry<TKey> : IReadOnlyPolicyRegistry<TKey>
  • int Count { get; }
  • bool ContainsKey(TKey key)
  • TPolicy Get<TPolicy>(TKey key) where TPolicy : IsPolicy
  • bool TryGet<TPolicy>(TKey key, out TPolicy policy) where TPolicy : IsPolicy
• public interface IReadOnlyPolicyRegistry<TKey>
  • int Count { get; }
  • IsPolicy this[TKey key] { get; }
  • bool ContainsKey(TKey key)
  • TPolicy Get<TPolicy>(TKey key) where TPolicy : IsPolicy
  • bool TryGet<TPolicy>(TKey key, out TPolicy policy) where TPolicy : IsPolicy

Polly.Utilities

• public static class SystemClock
  • public static Func<DateTimeOffset> DateTimeOffsetUtcNow