Struct HttpClient 

pub struct HttpClient { /* private fields */ }

HTTP 客户端

封装 reqwest，提供：

• 合理的默认配置
• 自动重试
• 与取消系统集成

使用层级

1. Level 3 - 便捷函数：get(), post_json()
2. Level 2 - 客户端实例：HttpClient::new(), HttpClient::builder()
3. Level 1 - 底层访问：client.inner() 获取 reqwest::Client

Example

// 默认配置
let client = HttpClient::new()?;
let resp = client.get("https://api.example.com/data").await?;

// 自定义配置
let client = HttpClient::builder()
    .timeout(Duration::from_secs(60))
    .max_retries(5)
    .build_client()?;

Implementations

impl HttpClient

pub fn new() -> Result<Self, HttpError>

使用默认配置创建客户端

pub fn with_config(config: HttpClientConfig) -> Result<Self, HttpError>

使用自定义配置创建客户端

pub fn builder() -> HttpClientConfigBuilder

创建配置构建器

pub fn config(&self) -> &HttpClientConfig

获取当前配置

pub fn inner(&self) -> &Client

访问底层 reqwest::Client（完全控制）

当封装无法满足需求时，可以直接使用 reqwest 的所有高级功能

pub async fn get(&self, url: &str) -> Result<Response, HttpError>

GET 请求

pub async fn post_json<T: Serialize>( &self, url: &str, body: &T, ) -> Result<Response, HttpError>

POST 请求（JSON body）

pub async fn post_form<T: Serialize>( &self, url: &str, body: &T, ) -> Result<Response, HttpError>

POST 请求（表单 body）

pub async fn put_json<T: Serialize>( &self, url: &str, body: &T, ) -> Result<Response, HttpError>

PUT 请求（JSON body）

pub async fn delete(&self, url: &str) -> Result<Response, HttpError>

DELETE 请求

pub async fn patch_json<T: Serialize>( &self, url: &str, body: &T, ) -> Result<Response, HttpError>

PATCH 请求（JSON body）

pub async fn head(&self, url: &str) -> Result<Response, HttpError>

HEAD 请求

pub fn request(&self, method: Method, url: &str) -> RequestBuilder

创建请求构建器

pub async fn execute( &self, builder: RequestBuilder, ) -> Result<Response, HttpError>

执行请求（带自动重试）

pub async fn execute_cancellable( &self, request: CancellableRequest, ) -> Result<Response, HttpError>

执行可取消的请求

Trait Implementations

impl Clone for HttpClient

fn clone(&self) -> HttpClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HttpClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for HttpClient

fn default() -> Self

Returns the “default value” for a type.