.NET ヘルプ

.NET Core Polly（開発者向けの動作方法）

公開済み 2023年7月26日

共有:

ポリーは、.NET レジリエンス戦略および一時的な障害処理ライブラリであり、開発者がリトライポリシー、サーキットブレーカー、タイムアウト、バルクヘッドアイソレーションポリシー、およびフォールバックなどのレジリエンスポリシーを表現できるようにします。 PollyはASP.NET Coreを対象としており、.NET Coreの回復力に欠かせないツールです。 Pollyはスレッドセーフで、複数の同時リクエストと成功したレスポンスの処理をサポートします。

このチュートリアルでは、過渡故障処理.NETライブラリであるPollyの詳細と、それをどのようにASP.NET CoreアプリケーションでのIronPDF. Pollyの各側面を深く掘り下げ、サーキット・ブレーカー・パターンの仕組みを説明し、バルクヘッドの分離とタイムアウトについて議論し、特定の例外や失敗したサービスを制御されたスレッドセーフな方法で失敗レスポンスで処理する方法を示します。

ポリー方針

一時的な障害は、アプリケーションがHTTPリクエストやデータベース、その他の外部リソースを通じてWebサービスと接続しようとするときによく発生します。これらの障害は、ネットワーク障害、一時的な接続問題、またはタイムアウトなどのように短時間で発生し、通常は短時間で自己修正されます。

Pollyは、さまざまな戦略を適用し、再試行ポリシー、高度なサーキットブレーカーポリシー、タイムアウトポリシー、フォールバックポリシー、バルクヘッドアイソレーションポリシーなどのポリシーを表現することによって、これらの過渡的な障害を管理します。

リトライポリシー

リトライポリシーは、リトライロジックを使用して失敗した同時リクエストを自動的に再試行します。これは、永遠に再試行するように設定したり、一定回数の自動再試行を行ったりすることが可能です。また、再試行の間に設定された時間間隔を待ったり、指数バックオフを使用することもできます。

サーキットブレーカー

サーキットブレーカーポリシーは、あらかじめ設定されたしきい値のリクエストに失敗した後、システムが特定のサービスを試すためのキャンセルトークンをサポートするようにします。サーキットブレーカー戦略は、カオスエンジニアリングや損傷を局所化するために船が防水扉を閉めるのに似ています。1つの障害が船全体を沈めることはありません。

タイムアウトポリシー

タイムアウトポリシーは、特定の.NETレジリエンスコードが実行できる最大時間を強制します。それは、楽観的タイムアウトと悲観的タイムアウトの2つの形式で提供されます。

フォールバックポリシー

フォールバック・ポリシーは、失敗が発生した場合に代替の値または動作を提供するために使用されます。このポリシーは、失敗するサービスが全体のプロセスを停止させるべきでない場合に役立ちます。

バルクヘッドアイソレーション

バルクヘッドの分離は、特定の操作に対して同時に実行できるリクエストの数を制限するために使用されます。

キャッシュポリシー

キャッシュポリシーは、同じ実行が再び呼び出された場合、Pollyが分散キャッシュ値を返すことができるように、実行の成功応答をキャッシュします。

ポリシーラップ

複数のポリシーをまとめて一つのユニットとして機能させることができます。

ポリシーの作成および構成

リトライポリシー

リトライポリシーはシンプルです: 特定の例外または障害が発生したときに、Pollyは基盤となるデリゲートを再度実行しようとします。リトライ回数、リトライ間隔、または指数バックオフ戦略を設定できます。そうでなければ、無限にリトライし続けます。 Here's an example: 例があります。

//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#

タイムアウトポリシー

タイムアウトポリシーは、サービスが合理的な時間内に応答しないシナリオを処理します。ポリーは2種類のタイムアウトを提供しています: 楽観的タイムアウトと悲観的タイムアウト。楽観的なタイムアウトは、別スレッドで動作し、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は、指数バックオフ戦略を使用して失敗したリクエストを最大3回再試行します。再試行の間隔は2秒、4秒、8秒です。 circuitBreakerPolicyは、30秒間の時間間隔内に2回連続で失敗が発生した場合に回路を開きます。

では、URL を PDF に変換する IronPDF コードを定義しましょう：

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のセットを繰り返し処理し、各URLをPDFに変換しようとします。リクエストが失敗した場合、例外がキャッチされ、適切なメッセージがコンソールに表示されます。

.NET Core Polly（開発者向けの動作）：図1 - URLをPDFに出力

結論

Pollyは、.NET Coreアプリケーションにおいてレジリエンスと一時的な障害処理を実装するための強力で柔軟なライブラリです。再試行ポリシーやサーキットブレーカーのようなポリシーを組み合わせることで、開発者は失敗を適切に処理する堅牢で耐障害性のあるシステムを構築することができます。

このチュートリアルでは、Polly を使って URL を PDF に変換する方法を IronPDF と共に検証しました。私たちは、リトライやサーキットブレーカーを含むPollyポリシーの定義と適用方法を学びました。異なるURLでポリシーもテストしました。また、以下についても対応可能ですHTMLをPDFに変換.

IronPDFは無料試用また、競争力のある価格からライセンスが開始されるため、プロジェクトでその機能を活用することができます。

< 以前
C# 文字列分割（開発者向けの使い方）

次へ >
Blazor vs MVC（開発者にとっての動作方法）