Struct HttpClient 

pub struct HttpClient { /* private fields */ }

HTTP 客户端封装

提供统一的 HTTP 请求方法，处理 URL 编码和响应解析

Implementations

impl HttpClient

pub fn new( base_url: impl Into<String>, timeout: Option<Duration>, ) -> ZtkResult<Self>

创建新的 HTTP 客户端

Arguments

• base_url - API 基础地址
• timeout - 请求超时时间 (可选)

Returns

返回 HttpClient 实例或错误

pub fn with_defaults() -> ZtkResult<Self>

使用默认配置创建 HTTP 客户端

使用默认的 API 基础地址和超时时间

pub fn base_url(&self) -> &str

获取基础 URL

pub async fn get<T, P>(&self, path: &str, params: &P) -> ZtkResult<T>

where T: DeserializeOwned, P: Serialize + ?Sized,

发送 GET 请求

Arguments

• path - API 路径
• params - 查询参数

Returns

返回反序列化后的响应数据或错误

pub async fn get_with_base_url<T, P>( &self, base_url: &str, path: &str, params: &P, ) -> ZtkResult<T>

where T: DeserializeOwned, P: Serialize + ?Sized,

发送 GET 请求 (使用自定义 base_url)

Arguments

• base_url - 自定义的 API 基础地址
• path - API 路径
• params - 查询参数

Returns

返回反序列化后的响应数据或错误

pub async fn post_form<T, P>(&self, path: &str, params: &P) -> ZtkResult<T>

where T: DeserializeOwned, P: Serialize + ?Sized,

发送 POST 请求 (表单格式)

Arguments

• path - API 路径
• params - 表单参数

Returns

返回反序列化后的响应数据或错误

pub async fn post_json<T, B>(&self, path: &str, body: &B) -> ZtkResult<T>

where T: DeserializeOwned, B: Serialize + ?Sized,

发送 POST 请求 (JSON 格式)

Arguments

• path - API 路径
• body - JSON 请求体

Returns

返回反序列化后的响应数据或错误

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.