1. IronPDF
  2. IronPDF 部落格
  3. .NET 幫助
  4. .NET Core Polly
.NET 幫助

.NET Core Polly（如何為開發者運作）

發佈 2023年7月26日
分享:

波利是一個 .NET 韌性策略和短暫故障處理庫，允許開發人員表達韌性策略，例如重試策略、電路中斷器、超時、艙壁隔離策略和回退。 Polly 針對 ASP.NET Core，使其成為 .NET Core 韌性的重要工具。 Polly 是執行緒安全的，並支援處理多個並發請求以獲得成功的回應。

本教程將提供有關暫態故障處理 .NET 庫 Polly 的更多詳細信息，以及如何與之配合使用。在 ASP.NET Core 應用程式中使用 IronPDF. 我們將深入探討 Polly 的每個方面，解釋斷路器模式的機制，討論隔艙隔離和超時，並展示如何以受控、線程安全的方式處理特定異常或失敗服務的失敗響應。

Polly 政策

當您的應用程式嘗試透過 HTTP 請求、資料庫或其他外部資源連接到網頁服務時，經常會發生暫時性故障。 這些故障，如網絡故障、臨時連接問題或超時，都是暫時的，通常在短時間內自行糾正。

Polly 通過應用不同的策略來管理這些瞬態故障，並表達出重試策略、高級斷路器策略、超時策略、回退策略和隔艙隔離策略等政策。

重试策略

重試策略使用重試邏輯自動重試失敗的並發請求。 它可以配置为无限重试或自动重试一定次数，并可以在重试之间等待设定的时间间隔，或者使用指数退避。

斷路器

斷路器策略讓您的系統在預設的失敗請求閾值後，支持使用取消權杖嘗試特定的服務。 斷路器策略類似於混沌工程或船隻關閉密閉門以局部化損害：一個故障不會讓整艘船沉沒。

超時政策

超時策略強制執行特定 .NET 韌性代碼的最大執行時間。 它有兩種風格：樂觀超時和悲觀超時。

後備政策

回退策略被用來在失敗的情況下提供替代值或行為。 此政策可在一個服務失敗時不應中止整個過程時派上用場。

隔離牆隔離

艙壁隔離用來限制對特定操作的並發請求數量，從而限制套接字耗盡的可能性，並維持受控的執行槽位數量。

快取策略

快取策略會快取執行的成功響應，因此如果再次調用相同的執行，Polly可以返回分散式快取的值。

政策包裝

允許我們將多個策略一起打包，使它們可以作為一個單元工作。

建立和配置政策

重试策略

重試策略很簡單：當發生特定異常或錯誤時，Polly 會嘗試再次執行底層委託。 您可以設定重試的次數、重試之間的時間間隔，或使用指數退避策略，否則將永遠重試。 這是個例子：

//extension method
var retryPolicy = Policy
    .Handle<HttpRequestException>()
    .WaitAndRetryAsync(3, retryAttempt => TimeSpan.FromSeconds(Math.Pow(2, retryAttempt)), 
    (exception, timeSpan, retryCount, context) =>
    {
        // This is the OnRetry delegate, where you can log or monitor failed requests
    });
//extension method
var retryPolicy = Policy
    .Handle<HttpRequestException>()
    .WaitAndRetryAsync(3, retryAttempt => TimeSpan.FromSeconds(Math.Pow(2, retryAttempt)), 
    (exception, timeSpan, retryCount, context) =>
    {
        // This is the OnRetry delegate, where you can log or monitor failed requests
    });
'extension method
Dim retryPolicy = Policy.Handle(Of HttpRequestException)().WaitAndRetryAsync(3, Function(retryAttempt) TimeSpan.FromSeconds(Math.Pow(2, retryAttempt)), Sub(exception, timeSpan, retryCount, context)
End Sub)
VB   C#

熔斷器策略

斷路器策略使 Polly 庫能夠監控故障，如果故障數量在指定期間內超過設定的閾值，電路就會「斷開」，並且在指定時間內阻止進一步的請求。這稱為「打開」狀態。 在這之後，電路進入「半開」狀態，允許一些流量檢查特定服務的健康狀況。如果這些請求成功且沒有發生故障，電路會關閉； 否則，它會再次開啟。

var circuitBreakerPolicy = Policy
    .Handle<HttpRequestException>()
    .CircuitBreakerAsync(5, TimeSpan.FromMinutes(1));
var circuitBreakerPolicy = Policy
    .Handle<HttpRequestException>()
    .CircuitBreakerAsync(5, TimeSpan.FromMinutes(1));
Dim circuitBreakerPolicy = Policy.Handle(Of HttpRequestException)().CircuitBreakerAsync(5, TimeSpan.FromMinutes(1))
VB   C#

超時政策

超時策略處理服務未在合理時間範圍內做出回應的情況。 Polly 提供兩種類型的超時：樂觀超時和悲觀超時。 樂觀超時在獨立執行緒上運作，並使用 CancellationToken 來取消底層操作。 悲觀超時會阻止父執行緒，直到操作完成或超時期限結束。

var timeoutPolicy = Policy.TimeoutAsync(30); // Optimistic timeout of 30 seconds
var timeoutPolicy = Policy.TimeoutAsync(30); // Optimistic timeout of 30 seconds
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

隔離牆隔離

隔艙隔離用於限制對特定服務的並發操作數量。它提供了一種隔離故障並防止其級聯的方法。 它還限制了我們對相依項目造成的負擔。

var bulkheadIsolationPolicy = Policy.BulkheadAsync(10, 20); // 10 concurrent actions, queue 20 additional actions
var bulkheadIsolationPolicy = Policy.BulkheadAsync(10, 20); // 10 concurrent actions, queue 20 additional actions
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

後備政策

當所有方法都失效時，回退策略可用於提供預設行為或替代值。

var fallbackPolicy = Policy
    .Handle<Exception>()
    .FallbackAsync<FallbackResult>(FallbackResult.SomethingWentWrong);
var fallbackPolicy = Policy
    .Handle<Exception>()
    .FallbackAsync<FallbackResult>(FallbackResult.SomethingWentWrong);
Dim fallbackPolicy = Policy.Handle(Of Exception)().FallbackAsync(Of FallbackResult)(FallbackResult.SomethingWentWrong)
VB   C#

封裝策略

可以使用 PolicyWrap 靈活地結合多個策略：

var policyWrap = Policy.WrapAsync(fallbackPolicy, retryPolicy, circuitBreakerPolicy, timeoutPolicy, bulkheadIsolationPolicy);
var policyWrap = Policy.WrapAsync(fallbackPolicy, retryPolicy, circuitBreakerPolicy, timeoutPolicy, bulkheadIsolationPolicy);
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

入門

要開始使用 Polly 與 IronPDF，請確保已安裝 Visual Studio，並在 .NET Core 中建立一個新的主控台應用程式專案。 在 Visual Studio 中打開 NuGet 套件管理員主控台，並安裝 Polly 和 IronPdf 套件：

Install-Package Polly
:ProductInstall Install-Package IronPdf

使用 Polly 與 IronPDF 將 URL 轉換為 PDF

IronPDF 的一個顯著特點是其HTML 轉換為 PDF 的功能確保版面和樣式保持不變。 此功能將網頁內容轉換為 PDF，非常適合報告、發票和文檔。 它支持將 HTML 文件、URL 和 HTML 字串轉換為 PDF。

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}
using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}
Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' 1. Convert HTML String to PDF
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
		Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
		pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")

		' 2. Convert HTML File to PDF
		Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
		Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
		pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class
VB   C#

讓我們通過一個使用Polly和IronPDF的例子來將 URL 轉換為 PDF. 假設我們有一個網絡服務，由於暫時性故障偶爾會失敗，我們希望使用Polly優雅地處理這些故障。

首先，我們在 Program.cs 文件中導入必要的命名空間：

using System;
using System.Threading.Tasks;
using Polly;
using Polly.Wrap;
using IronPdf;
using System;
using System.Threading.Tasks;
using Polly;
using Polly.Wrap;
using IronPdf;
Imports System
Imports System.Threading.Tasks
Imports Polly
Imports Polly.Wrap
Imports IronPdf
VB   C#

接下來，我們將定義我們的政策。 在此範例中，我們將使用重試和斷路器策略的結合來處理故障：

var retryPolicy = Policy
    .Handle<Exception>()
    .WaitAndRetryAsync(3, i => TimeSpan.FromSeconds(2 * i));

var circuitBreakerPolicy = Policy
    .Handle<Exception>()
    .CircuitBreakerAsync(2, TimeSpan.FromSeconds(30));
var retryPolicy = Policy
    .Handle<Exception>()
    .WaitAndRetryAsync(3, i => TimeSpan.FromSeconds(2 * i));

var circuitBreakerPolicy = Policy
    .Handle<Exception>()
    .CircuitBreakerAsync(2, TimeSpan.FromSeconds(30));
Dim retryPolicy = Policy.Handle(Of Exception)().WaitAndRetryAsync(3, Function(i) TimeSpan.FromSeconds(2 * i))

Dim circuitBreakerPolicy = Policy.Handle(Of Exception)().CircuitBreakerAsync(2, TimeSpan.FromSeconds(30))
VB   C#

retryPolicy 將重試失敗的請求最多三次，採用指數退避策略，在重試之間分別等待2秒、4秒和8秒。 如果在30秒的時間間隔內連續發生兩次故障，circuitBreakerPolicy 將打開電路。

現在，讓我們定義我們的 IronPDF 代碼以將 URL 轉換為 PDF：

var htmlToPdf = new ChromePdfRenderer();
var pdfBytes = await retryPolicy
    .WrapAsync(circuitBreakerPolicy)
    .ExecuteAsync(() =>
    {
        Console.WriteLine("Attempting to convert URL to PDF...");
        var result = htmlToPdf.RenderUrlAsPdfAsync("https://example.com");
        Console.WriteLine("Conversion successful!");
        return result;
    });

pdfBytes.SaveAs("output.pdf");
var htmlToPdf = new ChromePdfRenderer();
var pdfBytes = await retryPolicy
    .WrapAsync(circuitBreakerPolicy)
    .ExecuteAsync(() =>
    {
        Console.WriteLine("Attempting to convert URL to PDF...");
        var result = htmlToPdf.RenderUrlAsPdfAsync("https://example.com");
        Console.WriteLine("Conversion successful!");
        return result;
    });

pdfBytes.SaveAs("output.pdf");
Dim htmlToPdf = New ChromePdfRenderer()
Dim pdfBytes = Await retryPolicy.WrapAsync(circuitBreakerPolicy).ExecuteAsync(Function()
		Console.WriteLine("Attempting to convert URL to PDF...")
		Dim result = htmlToPdf.RenderUrlAsPdfAsync("https://example.com")
		Console.WriteLine("Conversion successful!")
		Return result
End Function)

pdfBytes.SaveAs("output.pdf")
VB   C#

在上述範例代碼中，我們使用 WrapAsync 方法將 retryPolicy 和 circuitBreakerPolicy 包裝起來。 這使我們能夠按順序對新請求應用多個策略。 ExecuteAsync 方法執行所提供的委派，而在此代碼中是 IronPDF 的 RenderUrlAsPdfAsync 方法。

通過應用Polly策略，我們確保程式碼能夠抵抗短暫性故障。 如果請求失敗，Polly 將根據重試策略自動重試該請求。 如果連續失敗的次數超過預設的閾值，斷路器策略將開啟電路，阻止在指定時間內的進一步請求。

Polly 策略測試案例

為了測試我們的Polly策略的有效性，讓我們模擬一些失敗的請求。 將 URL 修改為不存在的端點並添加一些測試案例：

var testUrls = new[]
{
    "https://ironpdf.com",
    "https://notexistingdomain.com/",
    "http://httpbin.org/delay/120"
};

foreach (var url in testUrls)
{
    try
    {
        var pdfBytes = await retryPolicy
            .WrapAsync(circuitBreakerPolicy)
            .ExecuteAsync(() => htmlToPdf.RenderUrlAsPdfAsync(url));

        pdfBytes.SaveAs($"{Guid.NewGuid()}.pdf");
        Console.WriteLine($"Successfully converted {url} to PDF.");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Failed to convert {url} to PDF: {ex.Message}");
    }
}
var testUrls = new[]
{
    "https://ironpdf.com",
    "https://notexistingdomain.com/",
    "http://httpbin.org/delay/120"
};

foreach (var url in testUrls)
{
    try
    {
        var pdfBytes = await retryPolicy
            .WrapAsync(circuitBreakerPolicy)
            .ExecuteAsync(() => htmlToPdf.RenderUrlAsPdfAsync(url));

        pdfBytes.SaveAs($"{Guid.NewGuid()}.pdf");
        Console.WriteLine($"Successfully converted {url} to PDF.");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Failed to convert {url} to PDF: {ex.Message}");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

在上述程式碼中，我們遍歷一組測試 URL，並嘗試將其中的每一個轉換為 PDF。 如果請求失敗，例外將被捕獲，並在控制台顯示適當的訊息。

.NET Core Polly（開發人員如何使用）：圖 1 - 網址到 PDF 輸出

結論

Polly 是一個強大且靈活的庫，用於在 .NET Core 應用程式中實現彈性和暫時性故障處理。 通過結合重試和斷路器等策略，開發人員可以建立健壯且容錯的系統，優雅地處理故障。

在本教程中，我們探討了如何使用 Polly 與 IronPDF 將 URL 轉換為 PDF。 我們學習了如何定義和應用Polly策略，包括重試和斷路器。 我們也使用不同的網址測試了我們的政策。 我們也可以為將 HTML 轉換為 PDF.

IronPDF 提供一個免費試用，且許可證以具競爭力的價格起售，允許您在專案中利用其功能。

< 上一頁
C# 字串分割（開發者應如何操作）
下一個 >
Blazor 與 MVC（如何為開發人員運作）
從NuGet 免費用於開發

安裝與 NuGet nuget.org/packages/IronPdf

PM > Install-Package IronPdf

報告問題

準備開始了嗎？ 版本: 2025.2 剛剛發布

免費 NuGet 下載 總下載次數： 12,371,841
免費開始
NuGet 下載 DLL 下載 Windows 安裝程式 開始免費試用
查看許可證 >