pub struct HttpClient { /* private fields */ }Expand description
HTTP 客户端
提供 HTTP 请求构建和发送能力。
内部持有 Arc<reqwest::Client>,clone() 时复用同一连接池(即 Arc::clone),
不会创建新的底层连接池。
§示例
ⓘ
use yang_base::http::HttpClient;
use yang_base::tools::ToolsBuilder;
// 启动期:把客户端注册进应用资源并冻结
let tools = ToolsBuilder::new().http(HttpClient::new(30)?).build()?;
// 运行期:从 Tools 获取客户端发起请求(Action 内为 ctx.http()?)
let response = tools.http()?
.get("https://api.example.com/users")
.send()
.await?;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 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
Auto Trait Implementations§
impl !RefUnwindSafe for HttpClient
impl !UnwindSafe for HttpClient
impl Forget for HttpClient
impl Freeze for HttpClient
impl Move 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