pub struct HttpClient { /* private fields */ }Expand description
Implementations§
Source§impl HttpClient
impl HttpClient
Sourcepub fn with_config(cfg: HttpClientConfig) -> Result<Self, BaseError>
pub fn with_config(cfg: HttpClientConfig) -> Result<Self, BaseError>
使用结构化配置创建 HTTP 客户端
§参数
cfg: HTTP 客户端配置
§返回
Ok(HttpClient): 客户端实例Err(BaseError::HttpClientCreateFailed): 创建失败(如代理 URL 无效)
§示例
ⓘ
use yang_base::http::{HttpClient, HttpClientConfig};
let config = HttpClientConfig {
timeout_secs: 60,
pool_max_idle_per_host: 20,
..Default::default()
};
let client = HttpClient::with_config(config)?;Sourcepub fn init_global_with_config(
config: HttpClientConfig,
) -> Result<(), BaseError>
pub fn init_global_with_config( config: HttpClientConfig, ) -> Result<(), BaseError>
使用完整配置初始化全局 HTTP 客户端
允许配置连接池大小、User-Agent、代理等高级选项。
重复调用返回 BaseError::HttpClientAlreadyInitialized。
§参数
config: HTTP 客户端配置
§返回
Ok(()): 初始化成功Err(BaseError::HttpClientAlreadyInitialized): 已初始化(重复调用)Err(BaseError::HttpClientCreateFailed): 客户端创建失败
§示例
ⓘ
use yang_base::http::HttpClientConfig;
let config = HttpClientConfig {
timeout_secs: 60,
pool_max_idle_per_host: 20,
user_agent: Some("MyApp/1.0".to_string()),
..Default::default()
};
HttpClient::init_global_with_config(config)?;Sourcepub fn init_global(timeout_secs: u64) -> Result<(), BaseError>
pub fn init_global(timeout_secs: u64) -> Result<(), BaseError>
初始化全局 HTTP 客户端(仅超时时间)
使用默认配置,仅覆盖超时时间。如需完整配置(连接池、UA、代理等),
请使用 init_global_with_config。
§参数
timeout_secs: 默认超时时间(秒)
§返回
Ok(()): 初始化成功Err(BaseError::HttpClientAlreadyInitialized): 已初始化(重复调用)Err(BaseError::HttpClientCreateFailed): 客户端创建失败
§示例
ⓘ
HttpClient::init_global(30)?;Sourcepub fn global() -> Result<&'static HttpClient, BaseError>
pub fn global() -> Result<&'static HttpClient, BaseError>
Sourcepub fn set_default_token(&self, token: String)
pub fn set_default_token(&self, token: String)
Sourcepub fn request(&self, method: Method, url: &str) -> RequestBuilder
pub fn request(&self, method: Method, url: &str) -> RequestBuilder
Sourcepub fn get(&self, url: &str) -> RequestBuilder
pub fn get(&self, url: &str) -> RequestBuilder
Sourcepub fn post(&self, url: &str) -> RequestBuilder
pub fn post(&self, url: &str) -> RequestBuilder
Sourcepub fn put(&self, url: &str) -> RequestBuilder
pub fn put(&self, url: &str) -> RequestBuilder
Sourcepub fn delete(&self, url: &str) -> RequestBuilder
pub fn delete(&self, url: &str) -> RequestBuilder
Trait Implementations§
Source§impl Clone for HttpClient
impl Clone for HttpClient
Source§fn clone(&self) -> HttpClient
fn clone(&self) -> HttpClient
Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from
source. Read moreAuto Trait Implementations§
impl !RefUnwindSafe for HttpClient
impl !UnwindSafe for HttpClient
impl Freeze for HttpClient
impl Send for HttpClient
impl Sync for HttpClient
impl Unpin for HttpClient
impl UnsafeUnpin for HttpClient
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more