在 ASP.NET Core 中使用 IHttpClientFactory 发出 HTTP 请求

在 ASP.NET Core 应用中，发出 HTTP 请求是一个常见的需求，无论是调用外部 API、访问微服务还是与其他远程服务进行交互。为了简化这一过程并提供更好的性能和可靠性，ASP.NET Core 引入了 IHttpClientFactory 接口。IHttpClientFactory 用于创建 HttpClient 实例，这些实例预配置了适当的设置，并可以重复使用，以减少资源消耗和提高性能。

一、为什么使用 IHttpClientFactory

在过去，开发者可能会直接在类中实例化 HttpClient，但这种方法有几个缺点：

1. 套接字耗尽：HttpClient 实例在底层使用 HttpMessageHandler 来管理 HTTP 连接。如果不正确地管理这些实例，可能会导致套接字耗尽，特别是在高负载或长时间运行的应用中。

2. 配置问题：每个 HttpClient 实例都需要单独配置，这增加了代码重复和出错的可能性。

3. 资源管理：正确管理 HttpClient 实例的生命周期和资源使用是一个挑战。

IHttpClientFactory 解决了这些问题，它提供了以下优势：

• 性能优化：通过重用 HttpMessageHandler 实例来减少资源消耗和提高性能。

• 配置简化：允许在中央位置配置 HttpClient 实例，减少代码重复。

• 弹性扩展：与 ASP.NET Core 的依赖注入（DI）系统集成，使得管理和使用 HttpClient 实例更加灵活。

二、如何使用 IHttpClientFactory

1. 注册服务

   在 Startup.cs 的 ConfigureServices 方法中，注册 IHttpClientFactory 服务：

   public void ConfigureServices(IServiceCollection services)
   {
       services.AddHttpClient();
       // 其他服务配置...
   }

2. 注入和使用 IHttpClientFactory

   在你的类中，通过构造函数注入 IHttpClientFactory，并使用它来创建 HttpClient 实例：

   public class MyService
   {
       private readonly IHttpClientFactory _clientFactory;
   
       public MyService(IHttpClientFactory clientFactory)
       {
           _clientFactory = clientFactory;
       }
   
       public async Task<string> GetDataAsync(string url)
       {
           var client = _clientFactory.CreateClient();
           return await client.GetStringAsync(url);
       }
   }

3. 配置命名客户端

   你可以配置具有特定设置的命名客户端。这些设置可以包括基础 URL、HTTP 头、超时等：

   public void ConfigureServices(IServiceCollection services)
   {
       services.AddHttpClient("MyNamedClient", client =>
       {
           client.BaseAddress = new Uri("http://example.com/");
           client.DefaultRequestHeaders.Add("Accept", "application/json");
           // 其他配置...
       });
       // 其他服务配置...
   }

   然后，你可以通过名称获取配置的客户端：

   var client = _clientFactory.CreateClient("MyNamedClient");

4. 使用 Typed Clients

   为了进一步提高代码的可维护性和可读性，你可以创建 Typed Clients。Typed Clients 是使用 IHttpClientFactory 创建的特定于应用的 HttpClient 类：

   public class MyTypedClient
   {
       private readonly HttpClient _client;
   
       public MyTypedClient(HttpClient client)
       {
           _client = client;
       }
   
       public async Task<string> GetDataAsync()
       {
           return await _client.GetStringAsync("/data");
       }
   }

   注册 Typed Client：

   public void ConfigureServices(IServiceCollection services)
   {
       services.AddHttpClient<MyTypedClient>(client =>
       {
           client.BaseAddress = new Uri("http://example.com/");
           // 其他配置...
       });
       // 其他服务配置...
   }

   使用 Typed Client：

   public class MyService
   {
       private readonly MyTypedClient _myClient;
   
       public MyService(MyTypedClient myClient)
       {
           _myClient = myClient;
       }
   
       public async Task<string> PerformActionAsync()
       {
           return await _myClient.GetDataAsync();
       }
   }

三、结论

IHttpClientFactory 是 ASP.NET Core 中一个强大的功能，它简化了 HTTP 请求的发出过程，同时提供了更好的性能和可靠性。通过使用 IHttpClientFactory，你可以减少资源消耗，避免套接字耗尽问题，并以更可维护和可扩展的方式管理 HttpClient 实例。无论是使用命名客户端还是 Typed Clients，IHttpClientFactory 都为你提供了灵活且强大的选项来发出 HTTP 请求。