C#调用Polly库实现捕捉异常处理的操作代码

 更新时间:2024年08月25日 08:53:43   作者:一个专注写bug的小白猿  
Polly 是一个 .NET 弹性和瞬态故障处理库,允许开发人员以 Fluent 和线程安全的方式来实现重试、断路、超时、隔离和回退策略,本文给大家介绍了C#调用Polly库实现捕捉异常处理操作,文中有详细的代码示例供大家参考,需要的朋友可以参考下

一、Polly介绍

官方对 Polly 的介绍是这样的:

Polly 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.

翻译过来大概意思是:Polly 是一个 .NET 弹性和瞬态故障处理库,允许开发人员以 Fluent 和线程安全的方式来实现重试、断路、超时、隔离和回退策略。

二、Polly 的七种策略

Polly 可以实现重试、断路、超时、隔离、回退和缓存策略

1、重试(Retry)

出现故障自动重试

//捕捉到错误,自动重试三次
Policy.Handle<Exception>()
 .Retry(3, (exception, retryCount) =>
 {
     Console.WriteLine(DateTime.Now + $"代码异常: {exception},开始第 {retryCount} 次重试。");
 });

2、 断路(Circuit-breaker)

当系统遇到严重问题时,快速回馈失败比让用户/调用者等待要好,限制系统出错的体量,有助于系统恢复。比如,当我们去调一个第三方的 API,有很长一段时间 API 都没有响应,可能对方服务器瘫痪了。如果我们的系统还不停地重试,不仅会加重系统的负担,还会可能导致系统其它任务受影响。所以,当系统出错的次数超过了指定的阈值,就要中断当前线路,等待一段时间后再继续。

//捕捉到同一个异常两次时,就停下来,等待 1 分钟后再继续
Policy.Handle<SomeException>()    
.CircuitBreaker(2, TimeSpan.FromMinutes(1));

3、 超时(Timeout)

当系统超过一定时间的等待,我们就几乎可以判断不可能会有成功的结果。比如平时一个网络请求瞬间就完成了,如果有一次网络请求超过了 30 秒还没完成,我们就知道这次大概率是不会返回成功的结果了。因此,我们需要设置系统的超时时间,避免系统长时间做无谓的等待。

//这里设置了超时时间不能超过 30 秒,否则就认为是错误的结果,并执行回调
Policy.Timeout(30, onTimeout: (context, timespan, task) => 
{   
    Console.WriteLine("30秒无响应,需要执行的逻辑");
});

4、 隔离(Bulkhead Isolation)

当系统的一处出现故障时,可能促发多个失败的调用,很容易耗尽主机的资源(如 CPU)。下游系统出现故障可能导致上游的故障的调用,甚至可能蔓延到导致系统崩溃。所以要将可控的操作限制在一个固定大小的资源池中,以隔离有潜在可能相互影响的操作。

//这个策略是最多允许 10 个线程并发执行,如果执行被拒绝,则执行回调
Policy.Bulkhead(10, context => 
{   
     Console.WriteLine("当前线程超过10个,需要执行的逻辑");
});

5、 回退(Fallback)

有些错误无法避免,就要有备用的方案。这个就像浏览器不支持一些新的 CSS 特性就要额外引用一个 polyfill 一样。一般情况,当无法避免的错误发生时,我们要有一个合理的返回来代替失败。

//当用户没有填写名称时,我们就给他一个默认名称,这种策略可以这样定义:
Policy.Handle<Whatever>()   
.Fallback<User>(() => User.GetDefaultName())

6、 缓存(Cache)

一般我们会把频繁使用且不会怎么变化的资源缓存起来,以提高系统的响应速度。如果不对缓存资源的调用进行封装,那么我们调用的时候就要先判断缓存中有没有这个资源,有的话就从缓存返回,否则就从资源存储的地方(比如数据库)获取后缓存起来,再返回,而且有时还要考虑缓存过期和如何更新缓存的问题。Polly 提供了缓存策略的支持,使得问题变得简单。

//这是官方的一个使用示例用法,
//它定义了缓存 5 分钟过期的策略,然后把这个策略应用在指定的 Key(即 `FooKey`)上。
var memoryCacheProvider = new MemoryCacheProvider(myMemoryCache); 
var cachePolicy = Policy.Cache(memoryCacheProvider, TimeSpan.FromMinutes(5)); 
TResult result = cachePolicy.Execute(context => getFoo(), new Context("FooKey"));

7、 策略包(Policy Wrap)

一种操作会有多种不同的故障,而不同的故障处理需要不同的策略。这些不同的策略必须包在一起,作为一个策略包,才能应用在同一种操作上。也就是 Polly 的弹性,即各种不同的策略能够灵活地组合起来。

//先是把预先定义好的多种不同的策略包在一起,作为一个整体策略,然后应用在同一个操作上。
var policyWrap = Policy  
.Wrap(fallback, cache, retry, breaker, timeout, bulkhead); 
policyWrap.Execute(() =>
{
    Console.WriteLine("多种策略共同执行的逻辑");
});

三、简单代码示例

备注:先引入Nuget包(Polly)

 //创建一个策略,用于处理异常,并进行重试
 public static Policy policy = Policy.Handle<Exception>()
 .Retry(3, (exception, retryCount) =>
 {
     Console.WriteLine(DateTime.Now + $"代码异常: {exception},开始第 {retryCount} 次重试。");
 });
 
 
  public async Task Execute()
  {
     //重试机制
     policy.Execute(() =>  //这里接收一个委托方法,也就是捕捉到异常之后要执行的业务逻辑
     {
         Console.WriteLine("重试");
     });
  }
  

以上就是C#调用Polly库实现捕捉异常处理的操作代码的详细内容,更多关于C# Polly库捕捉异常的资料请关注脚本之家其它相关文章!

相关文章

  • 聊一聊C# 8.0中的await foreach使用

    聊一聊C# 8.0中的await foreach使用

    这篇文章主要介绍了聊一聊C# 8.0中的await foreach使用,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2019-06-06
  • C#使用iTextSharp库将图片转换为PDF

    C#使用iTextSharp库将图片转换为PDF

    iTextSharp 是一个开源的 .NET 库,主要用于创建和操作 PDF 文档,本文主要介绍了如何使用 C# 和 iTextSharp 将图片转换为 PDF 的功能,需要的可以参考下
    2024-12-12
  • ASP.NET总结C#中7种获取当前路径的方法

    ASP.NET总结C#中7种获取当前路径的方法

    本文主要介绍了7种获取当前路径的方法,并做了代码演示,分享给大家,感兴趣的朋友可以参考一下。
    2016-03-03
  • 通过C#实现发送自定义的html格式邮件

    通过C#实现发送自定义的html格式邮件

    本篇文章主要介绍了通过C#实现发送自定义的html格式邮件,详细的介绍了发送HTML格式邮件的方法,有兴趣的可以了解一下。
    2017-02-02
  • C#实现倒计时关闭提示框功能

    C#实现倒计时关闭提示框功能

    最近小编接到一个功能需要实现一个提示框并且能自动关闭的,看到这个需求真是懵了,四处搜集资料才搞定,接下来通过本文给大家分享C#实现倒计时关闭提示框功能,感兴趣的朋友跟随小编一起看看吧
    2019-07-07
  • C#用websocket实现简易聊天功能(服务端)

    C#用websocket实现简易聊天功能(服务端)

    这篇文章主要为大家详细介绍了C#用websocket实现简易聊天功能,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-02-02
  • C#使用TimeSpan时间计算的简单实现

    C#使用TimeSpan时间计算的简单实现

    这篇文章主要给大家介绍了关于C#使用TimeSpan时间计算的相关资料,以及通过一个实例代码给大家介绍了C#使用timespan和timer完成一个简单的倒计时器的方法,需要的朋友可以参考借鉴,下面随着小编来一起学习学习吧
    2018-06-06
  • C#将图片和字节流互相转换并显示到页面上

    C#将图片和字节流互相转换并显示到页面上

    本文主要介绍用C#实现图片转换成字节流,字节流转换成图片,并根据图片路径返回图片的字节流,有需要的朋友可以参考下
    2015-08-08
  • C#在MySQL大量数据下的高效读取、写入详解

    C#在MySQL大量数据下的高效读取、写入详解

    最近由于工作的原因,经常需要对海量数据进行处理,做的数据爬虫相关,动辄千万级别的数据,单表几十个G 都是都是家常便饭。 那么主要的开发语言是C#,数据库使用的是MySQL。下面通过这篇文章我们来一起学习学习吧。
    2016-11-11
  • WPF实现绘制统计图(柱状图)的方法详解

    WPF实现绘制统计图(柱状图)的方法详解

    这篇文章主要为大家详细介绍了如何基于WPF实现实现统计图(柱状图)的绘制,文中的示例代码简洁易懂,对我们学习WPF有一定帮助,感兴趣的可以了解一下
    2022-07-07

最新评论