Struct RequestBuilder

pub struct RequestBuilder<'req, B, E>(/* private fields */);

API 请求构造器

Implementations

impl<'req, B, E> RequestBuilder<'req, B, E>

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

设置是否使用 HTTPS

pub fn version(&mut self, version: Version) -> &mut Self

设置 HTTP 协议版本

pub fn headers(&mut self, headers: impl Into<Cow<'req, HeaderMap>>) -> &mut Self

设置 HTTP 请求头

pub fn set_header( &mut self, header_name: impl IntoHeaderName, header_value: impl Into<HeaderValue>, ) -> &mut Self

添加 HTTP 请求头

pub fn query(&mut self, query: impl Into<Cow<'req, str>>) -> &mut Self

设置查询参数

pub fn query_pairs( &mut self, query_pairs: impl Into<Vec<QueryPair<'req>>>, ) -> &mut Self

设置查询参数

pub fn append_query_pair( &mut self, query_pair_key: impl Into<QueryPairKey<'req>>, query_pair_value: impl Into<QueryPairValue<'req>>, ) -> &mut Self

追加查询参数

pub fn extensions(&mut self, extensions: Extensions) -> &mut Self

设置扩展信息

pub fn add_extension<T: Send + Sync + 'static>(&mut self, val: T) -> &mut Self

添加扩展信息

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

上传进度回调函数

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

设置响应状态码回调函数

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

设置响应 HTTP 头回调函数

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

设置域名解析前回调函数

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

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

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

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

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

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

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

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

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

设置 HTTP 请求前回调函数

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

设置响应成功回调函数

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

设置响应错误回调函数

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

设置退避前回调函数

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

设置退避后回调函数

pub fn parts(&self) -> &RequestBuilderParts<'req>

获取 HTTP 请求构建器部分参数

pub fn parts_mut(&mut self) -> &mut RequestBuilderParts<'req>

获取 HTTP 请求构建器部分参数的可变引用

impl<'req, E: EndpointsProvider + Clone + 'req> RequestBuilder<'req, RequestBody<'req>, E>

pub fn call(&mut self) -> ApiResult<Response<ResponseBody>>

阻塞发起 HTTP 请求

impl<'req, E: EndpointsProvider + Clone + 'req> RequestBuilder<'req, AsyncRequestBody<'req>, E>

pub async fn call(&mut self) -> ApiResult<Response<ResponseBody>>

异步发起 HTTP 请求

Trait Implementations

impl<'req, B: Debug, E: Debug> Debug for RequestBuilder<'req, B, E>

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

Formats the value using the given formatter.