HttpClientFactory的简单使用

用个简单的控制台程序来演示

这里就只是获取一下状态码，没有获取实际的内容。

static async Task BasicUsage()
{
  var serviceCollection = new ServiceCollection();
  serviceCollection.AddHttpClient();
  var services = serviceCollection.BuildServiceProvider();
  var clientFactory = services.GetService();

  var client = clientFactory.CreateClient();
  var request = new HttpRequestMessage(HttpMethod.Get, "https://www.github.com");

  var response = await client.SendAsync(request).ConfigureAwait(false);

  return response.StatusCode.ToString();
}

其实主要的操作就是AddHttpClient，然后通过HttpClientFactory创建一个HttpClient对象，有了HttpClient对象，下面的操作应该就不用多说了。

然后在Main方法调用

Console.WriteLine($"BasicUsage, StatusCode = {BasicUsage().GetAwaiter().GetResult()}");

用法感觉并没有太多的差别。下面来看看与Polly的结合。

HttpClientFactory和Polly的结合

Polly的wiki页面已经有了这两者结合使用的文档了。

https://github.com/App-vNext/Polly/wiki/Polly-and-HttpClientFactory

其实现在对于我们来说，要想对http请求使用Polly的一些特性已经非常的简单了。

我们在使用的时候要添加Microsoft.Extensions.Http.Polly的Nuget包。

先来看看使用Polly的三种扩展方法

后面的操作，是用的AddPolicyHandler。

由于我们要实现熔断降级，所以，我们必不可少的要用到CircuitBreakerPolicy和FallbackPolicy，同时为了方便演示，再加个TimeoutPolicy。

由于涉及到多个Policy，所以我们必须要确定他们的执行顺序！

Polly的wiki页面有个示例，还配了一幅很详细的时序图。

一句话来说就是最先起作用的，还是最后添加的那个。

下面就新建一个API项目，用来演示一下。

修改ConfigureServices方法，具体如下

public void ConfigureServices(IServiceCollection services)
{
  var fallbackResponse = new HttpResponseMessage();
  fallbackResponse.Content = new StringContent("fallback");
  fallbackResponse.StatusCode = System.Net.HttpStatusCode.TooManyRequests;

  services.AddHttpClient("cb", x =>
  {
    x.BaseAddress = new Uri("http://localhost:8000");
    x.DefaultRequestHeaders.Add("User-Agent", "HttpClientFactory-Test");
  })
  //fallback
  .AddPolicyHandler(Policy.Handle().FallbackAsync(fallbackResponse, async b =>
  {
    Logger.LogWarning($"fallback here {b.Exception.Message}");
  }))
  //circuit breaker
  .AddPolicyHandler(Policy.Handle().CircuitBreakerAsync(2, TimeSpan.FromSeconds(4), (ex, ts) =>
  {
    Logger.LogWarning($"break here {ts.TotalMilliseconds}");
  }, () =>
  {        
    Logger.LogWarning($"reset here ");
  }))
  //timeout
  .AddPolicyHandler(Policy.TimeoutAsync(1));
   
  services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
}

然后是在控制器去使用。

[Route("api/[controller]")]
[ApiController]
public class ValuesController : ControllerBase
{
  private static int myCount = 0;

  private readonly IHttpClientFactory _clientFactory;

  public ValuesController(IHttpClientFactory clientFactory)
  {
    this._clientFactory = clientFactory;
  }

  // GET api/values/timeout
  [HttpGet("timeout")]
  public ActionResult> Timeout()
  {
    if (myCount < 3)//模拟超时
    {
      System.Threading.Thread.Sleep(3000);
    }
    myCount++;

    return new string[] { "value1", "value2" };
  }

  // GET api/values
  [HttpGet("")]
  public async Task GetAsync()
  {
    var client = _clientFactory.CreateClient("cb");
    
    var request = new HttpRequestMessage(HttpMethod.Get, "/api/values/timeout");
    var response = await client.SendAsync(request);
    var content = await response.Content.ReadAsStringAsync();

    return content;
  }
}

效果如下

前面几次请求，会因为超时或熔断，从而我们得到的结果是fallback。

过了4秒钟后再请求，由于没有超时，正常拿到了结果，所以熔断器会被reset。

来看看日志