FluentlyHttpClient 使用教程

1. 项目介绍

FluentlyHttpClient 是一个为 .NET Standard 设计的 HTTP 客户端库，提供了直观且易于使用的 Fluent API。该库旨在简化 HTTP 请求的创建和管理，同时保持高度的可扩展性。FluentlyHttpClient 支持多种功能，如中间件支持、依赖注入、请求和响应的统一处理、日志记录和计时器中间件等。

2. 项目快速启动

安装 FluentlyHttpClient

首先，通过 NuGet 安装 FluentlyHttpClient：

dotnet add package FluentlyHttpClient

创建和配置 HTTP 客户端

以下是一个简单的示例，展示如何创建和配置一个 HTTP 客户端：

using FluentlyHttpClient;
using System.Threading.Tasks;

public class Program
{
    public static async Task Main(string[] args)
    {
        // 创建 FluentHttpClientFactory
        var fluentHttpClientFactory = new FluentHttpClientFactory();

        // 创建并配置 HTTP 客户端
        var clientBuilder = fluentHttpClientFactory.CreateBuilder("platform")
            .WithBaseUrl("https://api.example.com")
            .WithHeader("user-agent", "my-app")
            .WithTimeout(10);

        // 注册 HTTP 客户端
        fluentHttpClientFactory.Add(clientBuilder);

        // 获取 HTTP 客户端
        var httpClient = fluentHttpClientFactory.Get("platform");

        // 发送 GET 请求
        var response = await httpClient.CreateRequest("/data")
            .ReturnAsResponse<MyData>();

        // 处理响应
        if (response.IsSuccessStatusCode)
        {
            var data = response.Data;
            Console.WriteLine(data);
        }
        else
        {
            Console.WriteLine("请求失败");
        }
    }
}

public class MyData
{
    public string Name { get; set; }
    public int Age { get; set; }
}

3. 应用案例和最佳实践

应用案例

FluentlyHttpClient 适用于需要频繁进行 HTTP 请求的应用场景，如 Web API 客户端、微服务之间的通信等。以下是一个实际应用案例：

假设你正在开发一个微服务架构的应用，其中一个服务需要从另一个服务获取数据。使用 FluentlyHttpClient 可以简化这一过程：

public class DataService
{
    private readonly IFluentHttpClient _httpClient;

    public DataService(IFluentHttpClientFactory fluentHttpClientFactory)
    {
        _httpClient = fluentHttpClientFactory.Get("data-service");
    }

    public async Task<MyData> GetDataAsync()
    {
        var response = await _httpClient.CreateRequest("/data")
            .ReturnAsResponse<MyData>();

        return response.Data;
    }
}

最佳实践

1. 使用连接池：FluentlyHttpClient 内部使用连接池技术，确保在高并发场景下性能稳定。
2. 配置超时时间：根据实际需求配置合理的超时时间，避免长时间等待。
3. 使用中间件：通过中间件可以方便地添加日志记录、错误处理等功能。

4. 典型生态项目

FluentlyHttpClient 可以与其他 .NET 生态项目无缝集成，以下是一些典型的生态项目：

• ASP.NET Core：可以与 ASP.NET Core 的依赖注入系统集成，简化 HTTP 客户端的管理。
• Serilog：通过中间件集成 Serilog，实现详细的日志记录。
• Polly：结合 Polly 实现重试、熔断等高级功能。

通过这些生态项目的集成，可以进一步提升 FluentlyHttpClient 的功能和灵活性。