Struct HttpClientBuilder

pub struct HttpClientBuilder { /* private fields */ }

HTTP 客户端构建器

Implementations

impl HttpClientBuilder

pub fn ureq() -> Self

创建一个新的 HTTP 客户端构建器，使用 crate::ureq::Client 作为 HttpCaller 实现

pub fn isahc() -> Result<Self, IsahcError>

创建一个新的 HTTP 客户端构建器，使用 crate::isahc::Client 作为 HttpCaller 实现

pub fn reqwest_sync() -> Self

创建一个新的 HTTP 客户端构建器，使用 crate::reqwest::SyncClient 作为 HttpCaller 实现

pub fn reqwest_async() -> Self

创建一个新的 HTTP 客户端构建器，使用 crate::reqwest::SyncClient 作为 HttpCaller 实现

pub fn new(http_caller: impl HttpCaller + 'static) -> Self

创建一个新的 HTTP 客户端构建器，需要指定 HttpCaller 实现

pub fn use_https(&mut self, use_https: bool) -> &mut Self

设置是否使用 HTTPS

默认为使用 HTTPS

pub fn appended_user_agent( &mut self, appended_user_agent: impl Into<UserAgent>, ) -> &mut Self

设置追加的 UserAgent

pub fn http_caller( &mut self, http_caller: impl HttpCaller + 'static, ) -> &mut Self

设置 HTTP 客户端实现

默认根据启用的功能自动选择。

pub fn request_retrier( &mut self, request_retrier: impl RequestRetrier + 'static, ) -> &mut Self

设置重试器

默认使用 ErrorRetrier，并使用 LimitedRetrier 对其进行包装。

pub fn backoff(&mut self, backoff: impl Backoff + 'static) -> &mut Self

设置退避器

默认使用 ExponentialBackoff，并使用 LimitedBackoff 和 RandomizedBackoff 对其进行包装。

pub fn chooser(&mut self, chooser: impl Chooser + 'static) -> &mut Self

设置选择器

默认使用 SubnetChooser，并使用 ShuffledChooser 和 NeverEmptyHandedChooser 对其进行包装。

pub fn resolver(&mut self, resolver: impl Resolver + 'static) -> &mut Self

设置域名解析器

默认通过当前启用的功能来判定，并使用 CachedResolver 和 ShuffledResolver 对其进行包装。

pub fn on_uploading_progress( &mut self, callback: impl Fn(&dyn SimplifiedCallbackContext, TransferProgressInfo<'_>) -> AnyResult<()> + Send + Sync + 'static, ) -> &mut Self

设置上传进度回调函数

pub fn on_receive_response_status( &mut self, callback: impl Fn(&dyn SimplifiedCallbackContext, StatusCode) -> AnyResult<()> + Send + Sync + 'static, ) -> &mut Self

设置响应状态码回调函数

pub fn on_receive_response_header( &mut self, callback: impl Fn(&dyn SimplifiedCallbackContext, &HeaderName, &HeaderValue) -> AnyResult<()> + Send + Sync + 'static, ) -> &mut Self

设置响应 HTTP 头回调函数

pub fn on_to_resolve_domain( &mut self, callback: impl Fn(&mut dyn CallbackContext, &str) -> AnyResult<()> + Send + Sync + 'static, ) -> &mut Self

设置域名解析前回调函数

pub fn on_domain_resolved( &mut self, callback: impl Fn(&mut dyn CallbackContext, &str, &ResolveAnswers) -> AnyResult<()> + Send + Sync + 'static, ) -> &mut Self

设置域名解析成功回调函数

pub fn on_to_choose_ips( &mut self, callback: impl Fn(&mut dyn CallbackContext, &[IpAddrWithPort]) -> AnyResult<()> + Send + Sync + 'static, ) -> &mut Self

设置 IP 地址选择前回调函数

pub fn on_ips_chosen( &mut self, callback: impl Fn(&mut dyn CallbackContext, &[IpAddrWithPort], &[IpAddrWithPort]) -> AnyResult<()> + Send + Sync + 'static, ) -> &mut Self

设置 IP 地址选择成功回调函数

pub fn on_before_request_signed( &mut self, callback: impl Fn(&mut dyn ExtendedCallbackContext) -> AnyResult<()> + Send + Sync + 'static, ) -> &mut Self

设置 HTTP 请求签名前回调函数

pub fn on_after_request_signed( &mut self, callback: impl Fn(&mut dyn ExtendedCallbackContext) -> AnyResult<()> + Send + Sync + 'static, ) -> &mut Self

设置 HTTP 请求前回调函数

pub fn on_response( &mut self, callback: impl Fn(&mut dyn ExtendedCallbackContext, &ResponseParts) -> AnyResult<()> + Send + Sync + 'static, ) -> &mut Self

设置 HTTP 响应成功回调函数

pub fn on_error( &mut self, callback: impl Fn(&mut dyn ExtendedCallbackContext, &mut ResponseError) -> AnyResult<()> + Send + Sync + 'static, ) -> &mut Self

设置 HTTP 响应出错回调函数

pub fn on_before_backoff( &mut self, callback: impl Fn(&mut dyn ExtendedCallbackContext, Duration) -> AnyResult<()> + Send + Sync + 'static, ) -> &mut Self

设置退避前回调函数

pub fn on_after_backoff( &mut self, callback: impl Fn(&mut dyn ExtendedCallbackContext, Duration) -> AnyResult<()> + Send + Sync + 'static, ) -> &mut Self

设置退避后回调函数

pub fn build(&mut self) -> HttpClient

构建 HTTP 客户端

Trait Implementations

impl Debug for HttpClientBuilder

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

Formats the value using the given formatter.

impl Default for HttpClientBuilder

fn default() -> Self

Returns the “default value” for a type.