Polly 开源项目教程

Polly 开源项目教程

PollyPolly is a .NET resilience and transient-fault-handling library that allows developers to express policies such as Retry, Circuit Breaker, Timeout, Bulkhead Isolation, and Fallback in a fluent and thread-safe manner. From version 6.0.1, Polly targets .NET Standard 1.1 and 2.0+.项目地址:https://gitcode.com/gh_mirrors/po/Polly

项目介绍

Polly 是一个 .NET 的弹性和瞬态故障处理库，允许开发者以流畅和线程安全的方式表达弹性策略，如重试（Retry）、断路器（Circuit Breaker）、超时（Timeout）、舱壁隔离（Bulkhead Isolation）和回退（Fallback）。Polly 是 .NET Foundation 的成员之一，通过 thepollyproject.org 网站可以获取最新的功能公告、技巧和新闻。

项目快速启动

安装 Polly

首先，你需要在你的项目中添加 Polly 核心包。可以通过以下命令来安装：

dotnet add package Polly.Core

创建和执行弹性管道

以下是一个简单的示例，展示如何使用 Polly 创建一个包含重试策略的弹性管道，并执行它：

using Polly;
using Polly.Retry;

// 定义一个简单的重试策略
var retryPolicy = Policy
    .Handle<SomeExceptionType>()
    .RetryAsync(3);

// 使用弹性管道执行回调
await retryPolicy.ExecuteAsync(async () =>
{
    // 你的自定义逻辑在这里
});

应用案例和最佳实践

重试策略

在网络请求中，由于网络波动，请求可能会失败。使用 Polly 的重试策略可以自动重试失败的请求，提高系统的稳定性。

var retryPolicy = Policy
    .Handle<HttpRequestException>()
    .WaitAndRetryAsync(new[]
    {
        TimeSpan.FromSeconds(1),
        TimeSpan.FromSeconds(2),
        TimeSpan.FromSeconds(3)
    });

await retryPolicy.ExecuteAsync(async () =>
{
    // 发起网络请求
});

断路器策略

当系统的一部分频繁失败时，断路器策略可以防止系统过载，并在一段时间后尝试恢复。

var circuitBreakerPolicy = Policy
    .Handle<SomeExceptionType>()
    .CircuitBreakerAsync(
        exceptionsAllowedBeforeBreaking: 3,
        durationOfBreak: TimeSpan.FromMinutes(1)
    );

await circuitBreakerPolicy.ExecuteAsync(async () =>
{
    // 你的关键操作
});

典型生态项目

Polly 可以与其他 .NET 生态系统项目集成，例如：

• ASP.NET Core: 通过中间件集成 Polly，实现全局的弹性策略。
• HttpClientFactory: 与 HttpClientFactory 集成，为 HTTP 请求提供弹性策略。
• Microsoft.Extensions.DependencyInjection: 通过依赖注入支持，简化策略的配置和管理。

通过这些集成，Polly 可以在更广泛的场景中提供弹性和故障处理能力，提升系统的整体可靠性。

PollyPolly is a .NET resilience and transient-fault-handling library that allows developers to express policies such as Retry, Circuit Breaker, Timeout, Bulkhead Isolation, and Fallback in a fluent and thread-safe manner. From version 6.0.1, Polly targets .NET Standard 1.1 and 2.0+.项目地址:https://gitcode.com/gh_mirrors/po/Polly