Rabbit.Common.Http 1.2.0

Rabbit.Common.Http

HTTP 客户端组件，封装常用 HTTP 请求操作。

安装

dotnet add package Rabbit.Common.Http

依赖

• Rabbit.Common.Lite
• Microsoft.Extensions.Http 10.0.4

功能

• GET/POST 请求封装
• 支持多种编码（UTF-8、GBK 等）
• JSON/FormData 自动序列化
• 自定义请求头

使用方式

Console 项目

using Microsoft.Extensions.DependencyInjection;
using Rabbit.Common.Http;

// 1. 创建 DI 容器
var services = new ServiceCollection();

// 2. 注册 HttpClient
services.AddHttpClientHelperConfigure(
    timeoutSeconds: 30,
    configureHttpClient: client =>
    {
        client.DefaultRequestHeaders.Add("X-Api-Key", "your-key");
    }
);

// 3. 构建服务提供者
var provider = services.BuildServiceProvider();

// 4. 发送请求
var http = provider.GetRequiredService<HttpClientHelper>();

// GET 请求
var result = await http.GetAsync("https://api.example.com/data");

// GET 并反序列化
var user = await http.GetAsync<User>("https://api.example.com/users/1");

// POST JSON
var response = await http.PostJsonAsync(
    "https://api.example.com/users",
    new { Name = "Test", Age = 25 }
);

Web API 项目

using Rabbit.Common.Http;

services.AddHttpClientHelperConfigure(
    timeoutSeconds: 30,
    configureHttpClient: client =>
    {
        client.DefaultRequestHeaders.Add("X-Api-Key", "your-key");
    }
);

使用示例

public class ThirdPartyService
{
    private readonly HttpClientHelper _http;
    
    public ThirdPartyService(HttpClientHelper http)
    {
        _http = http;
    }
    
    // GET 请求
    public async Task<string> GetData(string url)
    {
        return await _http.GetAsync(url);
    }
    
    // GET 并反序列化
    public async Task<WeatherData?> GetWeather(string city)
    {
        var url = $"https://api.weather.com/v1/current?city={city}";
        return await _http.GetAsync<WeatherData>(url);
    }
    
    // POST JSON
    public async Task<string> PostOrder(Order order)
    {
        return await _http.PostJsonAsync(
            "https://api.example.com/orders",
            order
        );
    }
    
    // POST FormData
    public async Task<string> UploadForm(Dictionary<string, string> data)
    {
        return await _http.PostFormDataAsync(
            "https://api.example.com/form",
            data
        );
    }
}

使用 GBK 编码

// 某些老系统使用 GBK 编码
var content = await _http.GetAsync(
    url,
    encoding: Encoding.GetEncoding("GBK")
);

JSON 时间转换器

// 处理 yyyy-MM-dd HH:mm:ss 格式
var options = new JsonSerializerOptions
{
    Converters = { new JsonDateTimeConverter() }
};

API 参考

许可证

MIT