详解如何在ASP.NET Core中使用IHttpClientFactory_实用技巧

来源:脚本之家  责任编辑:小易  

利用IHttpClientFactory可以无缝创建HttpClient实例,避免手动管理它们的生命周期。

当使用ASP.Net Core开发应用程序时,可能经常需要通过HttpClient调用WebAPI的方法以检查终结点是否正常工作。要实现这一点,通常需要实例化HttpClient并使用该实例来调用你的方法。但是直接使用HttpClient也有一些缺点,主要与手动管理实例的生命周期有关。

你可以使用IHttpClientFactory创建HttpClient来避免这些问题。IHttpClientFactory是在.Net Core 2.1引入的,它提供了一个命名,配置和创建HttpClient实例的核心功能,并能自动管理实例的池化和生命周期。

下面我们通过代码进一步讨论HttpClient和IHttpClientFactory,以及所设计的概念。要使用提供的代码,你需要安装Visual Studio 2019。

在Visual Studio 2019中创建一个ASP.NET Core MVC项目

假设你的系统中安装了Visual Studio 2019,请按照下面列出来的步骤创建一个新的ASP.NET Core项目。
1. 启动Visual Studio IDE。
2. 点击“创建新项目”。
3. 在“创建新项目”窗口中,从模板列表中选择ASP.NET Core Web应用程序。
4. 单击Next。
5. 在“配置新项目”窗口中,指定新项目的名称和位置。
6. 可以选择“将解决方案和项目放在同一个目录中”复选框。
7. 点击Create。
8. 在“创建一个新的ASP.NET Core Web应用程序“窗口中,选择。NET Core作为运行时,然后选择asp.net Core作为运行时。NET Core 3.1(或更高版本)。
9. 选择“Web Application (Model-View-Controller)”作为项目模板来创建一个新的ASP.NET Core MVC应用程序。
10. 确保复选框“启用Docker支持”和“配置HTTPS”没有选中,因为我们不会在这里使用这些特性。
11. 确保身份验证设置为“无身份验证”,因为我们也不会使用身份验证。
12. 单击Create。

按照这些步骤将创建一个新的ASP.NET Core MVC应用程序。在新项目中,创建一个新的API Controller,并使用默认名称保存它,即ValuesController。我们将在接下来的部分中使用这个项目。

挑战HttpClient

尽管HttpClient没有直接实现IDisposable接口,但它扩展了System.Net.Http。HttpMessageInvoker,这个类实现了IDisposable。然而,当使用HttpClient实例时,你不应该手动操作释放它们。尽管可以在HttpClient实例上调用Dispose方法,但不推荐这样做。
应该怎么做呢?一种选择是使HttpClient静态化,或者将HttpClient的非静态实例包装在自定义类中,并使其成为单例类。但是更好的替代方法是使用IHttpClientFactory来生成HttpClient的实例,然后使用该实例来调用操作方法。

IHttpClientFactory 和HttpClientFactory

IHttpClientFactory是一个由DefaultHttpClientFactory类实现的接口,这是一个工厂模式。DefaultHttpClientFactory实现了IHttpClientFactory和IHttpMessageHandlerFactory接口。IHttpClientFactory提供了ASP.NET Core对创建、缓存和处理HttpClient实例提供了出色的内置支持。
请注意,HttpClientFactory只是一个帮助类,用于创建使用提供的处理程序配置的HttpClient实例。这个类有以下方法:

Create(DelegatingHandler[])
Create(HttpMessageHandler,DelegatingHandler[])
CreatePipeline(HttpMessageHandler,IEnumerable<DelegatingHandler>)

重载的HttpClientFactory类的Create方法看起来像这样:

public static HttpClient Create(params DelegatingHandler[] handlers)
{
 return Create(new HttpClientHandler(), handlers);
}
public static HttpClient Create(HttpMessageHandler innerHandler, params DelegatingHandler[] handlers)
{
 HttpMessageHandler pipeline = CreatePipeline(innerHandler, handlers);
 return new HttpClient(pipeline);
}

引入HttpClientFactory和IHttpClientFactory是为了更好地管理HttpMessageHandler实例的生命周期。

为什么使用IHttpClientFactory?

当你释放HttpClient实例时,连接将保持打开状态长达4分钟。此外,可以在任何时间点打开socket的数量是有限制的——不能同时打开太多socket。因此,当使用太多HttpClient实例时,可能会耗尽socket。
这就是IHttpClientFactory的意义所在。你可以通过利用IHttpClientFactory来创建用于调用HTTP API方法的HttpClient实例,以避免HttpClient所面临的问题。在ASP.NET Core中实现IHttpClientFactory的主要目标是为了确保使用工厂模式创建HttpClient实例的同时避免socket耗尽。

在ASP.NET Core中注册IHttpClientFactory实例

你可以在Startup类的ConfigureServices方法中,通过调用IServiceCollection实例上的AddHttpClient扩展方法注册一个IHttpClientFactory类型的实例,如下:

public void ConfigureServices(IServiceCollection services)
{
  services.AddControllersWithViews();
  services.AddHttpClient();
}

将IHttpClientFactory实例注入到控制器

可以通过如下代码将将IHttpClientFactory实例注入到控制器:

public class HomeController : Controller
{
   private IHttpClientFactory _httpClientFactory;
   private readonly ILogger<HomeController> _logger;
   public HomeController(ILogger<HomeController> logger,
   IHttpClientFactory httpClientFactory)
   {
      _logger = logger;
      _httpClientFactory = httpClientFactory;
   }
}

在Action中调用HttpClient

要通过使用IHttpClientFactory创建HttpClient,应该调用CreateClient方法。一旦HttpClient实例可用,就可以在HomeController类的index方法中使用以下代码来调用ValuesController类的Get方法。

public async Task<IActionResult> Index()
{
  HttpClient httpClient = _httpClientFactory.CreateClient();
  httpClient.BaseAddress = new Uri("http://localhost:1810/");
  var response = await httpClient.GetAsync("/api/values");
  string str = await response.Content.ReadAsStringAsync();
  List<string> data = JsonSerializer.Deserialize<List<string>>(str);
  return View(data);
}

使用IHttpClientFactory在ASP.NET Core中创建和管理HttpClient实例

有几种方法可以在应用程序中使用IHttpClientFactory。这包括直接使用IHttpClientFactory、使用命名client和类型client。
基本的或一般的使用模式,即直接使用IHttpClientFactory—在前面的小节中已经讨论过了。请参考“注册一个IHttpClientFactory实例”一节,该节讨论了如何注册HttpClient实例。

如果你想使用不同配置的HttpClient实例,以下是一个不错的选择。下面的代码片段说明了如何创建。

services.AddHttpClient("github", c =>
{
  c.BaseAddress = new Uri("https://api.github.com/");
  c.DefaultRequestHeaders.Add("Accept",
  "application/vnd.github.v3+json");
  c.DefaultRequestHeaders.Add("User-Agent", "This is a test user agent");
});

第二种方法是使用包装了HttpClient实例的自定义类,该自定义类封装了通过HTTP协议调用所有终结点的逻辑。下面的代码片段说明了如何定义自定义HttpClient类。

public class ProductService : IProductService
{
  private IHttpClientFactory _httpClientFactory;
  private readonly HttpClient _httpClient;
  private readonly string _baseUrl = "http://localhost:1810/";
  public ProductService(HttpClient httpClient)
  {
    _httpClient = httpClient;
  }
  public async Task<Catalog> GetAllProducts()
  {
    _httpClient = _httpClientFactory.CreateClient();
    _httpClient.BaseAddress = new Uri(_baseUrl);
    var uri = "/api/products";
    var result = await _httpClient.GetStringAsync(uri);
    return JsonConvert.DeserializeObject<Product>(result);
  }
}

通过以下代码注册自定义的client:

services.AddHttpClient<IProductService, ProductService>();

将MessageHandler添加到命名管道中

MessageHandler是扩展自HttpMessageHandler类,它可以接受HTTP请求并返回HTTP响应。如果你想构建自己的MessageHandler,你应该创建一个继承DelegatingHandler的类。

你可以将HttpMessageHandler添加到请求处理管道中。可以在Startup类的ConfigureServices方法中使用以下代码将HttpMessageHandler添加到管道中。

public void ConfigureServices(IServiceCollection services)
{
  services.AddHttpClient("github", c =>
  {
    c.BaseAddress = new Uri("https://api.github.com/");
  })
  .AddHttpMessageHandler<DemoHandler>();
  services.AddTransient<DemoHandler>();
}

IHttpClientFactory是一个自.net Core 2.1以来就可用的工厂类。如果你使用IHttpClientFactory来创建HttpClient实例,那么底层HttpClientMessagehandler实例的池化和生命周期将自动管理。IHttpClientFactory还负责处理一些常见问题,比如日志记录。

到此这篇关于详解如何在ASP.NET Core中使用IHttpClientFactory的文章就介绍到这了,更多相关ASP.NET Core使用IHttpClientFactory内容请搜索真格学网以前的文章或继续浏览下面的相关文章希望大家以后多多支持真格学网!

您可能感兴趣的文章:Asp.Net Core2.1前后使用HttpClient的两种方式ASP.NET Core针对一个使用HttpClient对象的类编写单元测试详解

  • 本文相关:
  • asp.net repeater绑定时使用函数
  • vs2010 水晶报表的使用方法
  • 从别人那拷下来的几点session使用的经验
  • asp.net core2.2多用户验证与授权示例详解
  • asp.net checbox在gridview中的应用实例分析
  • .net core部署到centos的图文教程
  • iis 浏览aspx页面出现无法显示xml页的解决方法分享
  • gridview高效分页和搜索功能的实现代码
  • asp.net下日期和时间处理的类库
  • asp.net中集成百度编辑器ueditor
  • 如何安装aspnetcoremodule
  • microsoft.aspnetcore.http 在哪个dll中
  • 网站首页网页制作脚本下载服务器操作系统网站运营平面设计媒体动画电脑基础硬件教程网络安全基础应用实用技巧自学过程首页asp.netasp.net core2.1前后使用httpclient的两种方式asp.net core针对一个使用httpclient对象的类编写单元测试详解asp.net repeater绑定时使用函数vs2010 水晶报表的使用方法从别人那拷下来的几点session使用的经验asp.net core2.2多用户验证与授权示例详解asp.net checbox在gridview中的应用实例分析.net core部署到centos的图文教程iis 浏览aspx页面出现无法显示xml页的解决方法分享gridview高效分页和搜索功能的实现代码asp.net下日期和时间处理的类库asp.net中集成百度编辑器ueditor未将对象引用设置到对象的实例 (java正则表达式 pattern和matcheasp.net(c#)网页跳转七种方法小结未能加载文件或程序集“xxx”或它asp.net“服务器应用程序不可用”asp.net中的几种弹出框提示基本实asp.net gridview 72般绝技asp.net生成excel并导出下载五种asp.net对路径"xxxxx"asp.net汉字转拼音和获取汉字首字asp.net iis 无法显示网页的解决方法分析javascript操作asp.net服务器控件asp.net使用webservice实现天气预报功能asp.net mvc 文件上传教程(一)visual studio 2012安装配置方法图文教程asp.net2.0 sql server数据库连接详解在asp.net中获取当前页面的url的方法(推荐剖析asp.net路由系统实现原理asp.net中使用gridview实现分级显示的代码asp.net页面请求超时时间设置多种方法
    免责声明 - 关于我们 - 联系我们 - 广告联系 - 友情链接 - 帮助中心 - 频道导航
    Copyright © 2017 www.zgxue.com All Rights Reserved