Struct qiniu_http_client::RequestBuilder

pub struct RequestBuilder<'r, B: 'r, E: 'r> { /* private fields */ }

Expand description

Implementations

设置是否使用 HTTPS

设置 HTTP 协议版本

设置 HTTP 请求路径

设置 HTTP 响应预期为 JSON 类型

设置 HTTP 响应预期为二进制流类型

追加 UserAgent

设置响应 HTTP 头回调函数

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

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

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

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

设置 HTTP 请求前回调函数

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

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

转换为 HTTP 请求构建器部分参数

设置 HTTP 请求体为输入流

设置 HTTP 请求体为输入流的可变引用

设置 HTTP 请求体为内存数据

设置 HTTP 请求体为内存数据的引用

设置 HTTP 请求体为 JSON 对象

设置 HTTP 请求体为表单对象

设置 HTTP 请求体为 Multipart 表单对象

阻塞发起 HTTP 请求

设置 HTTP 请求体为异步输入流

设置 HTTP 请求体为异步输入流的可变引用

设置 HTTP 请求体为内存数据

设置 HTTP 请求体为内存数据的引用

设置 HTTP 请求体为 JSON 对象

设置 HTTP 请求体为表单对象

设置 HTTP 请求体为 Multipart 表单对象

异步发起 HTTP 请求

Trait Implementations

Formats the value using the given formatter. Read more

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Converts self into T using Into<T>. Read more

Returns the argument unchanged.

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Pipes by value. This is generally the method you want to use. Read more

Borrows self and passes that borrow into the pipe function. Read more

Mutably borrows self and passes that borrow into the pipe function. Read more

Borrows self, then passes self.borrow() into the pipe function. Read more

Mutably borrows self, then passes self.borrow_mut() into the pipe function. Read more

Borrows self, then passes self.as_ref() into the pipe function.

Mutably borrows self, then passes self.as_mut() into the pipe function. Read more

Borrows self, then passes self.deref() into the pipe function.

Mutably borrows self, then passes self.deref_mut() into the pipe function. Read more

Should always be Self

Immutable access to a value. Read more

Mutable access to a value. Read more

Immutable access to the Borrow of a value. Read more

Mutable access to the BorrowMut of a value. Read more

Immutable access to the AsRef<R> view of a value. Read more

Mutable access to the AsMut<R> view of a value. Read more

Immutable access to the Deref::Target of a value. Read more

Mutable access to the Deref::Target of a value. Read more

Calls .tap() only in debug builds, and is erased in release builds.

Calls .tap_mut() only in debug builds, and is erased in release builds. Read more

Calls .tap_borrow() only in debug builds, and is erased in release builds. Read more

Calls .tap_borrow_mut() only in debug builds, and is erased in release builds. Read more

Calls .tap_ref() only in debug builds, and is erased in release builds. Read more

Calls .tap_ref_mut() only in debug builds, and is erased in release builds. Read more

Calls .tap_deref() only in debug builds, and is erased in release builds. Read more

Calls .tap_deref_mut() only in debug builds, and is erased in release builds. Read more

Attempts to convert self into T using TryInto<T>. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

Struct qiniu_http_client::RequestBuilder

Implementations

impl<'r, B: 'r, E: 'r> RequestBuilder<'r, B, E>

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

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

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

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

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

pub fn accept_json(&mut self) -> &mut Self

pub fn accept_application_octet_stream(&mut self) -> &mut Self

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

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

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

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

pub fn authorization(&mut self, authorization: Authorization<'r>) -> &mut Self

pub fn idempotent(&mut self, idempotent: Idempotent) -> &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<'_>) -> CallbackResult + Send + Sync + 'r) -> &mut Self

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

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

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

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

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

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

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

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

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

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

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

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

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

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

pub fn into_parts(self) -> RequestBuilderParts<'r>

impl<'r, E: 'r> RequestBuilder<'r, RequestBody<'r>, E>

pub fn stream_as_body( &mut self, body: impl Read + Reset + Debug + Send + Sync + 'static, content_length: u64, content_type: Option<Mime>) -> &mut Self

pub fn referenced_stream_as_body<T: Read + Reset + Debug + Send + Sync>( &mut self, body: &'r mut T, content_length: u64, content_type: Option<Mime>) -> &mut Self

pub fn bytes_as_body( &mut self, body: impl Into<Vec<u8>>, content_type: Option<Mime>) -> &mut Self

pub fn referenced_bytes_as_body( &mut self, body: &'r [u8], content_type: Option<Mime>) -> &mut Self

pub fn json(&mut self, body: impl Serialize) -> JsonResult<&mut Self>

pub fn post_form<I, K, V>(&mut self, iter: I) -> &mut Selfwhere I: IntoIterator, I::Item: Borrow<(K, Option<V>)>, K: AsRef<str>, V: AsRef<str>,

pub fn multipart<'a>( &mut self, multipart: impl Into<SyncMultipart<'a>>) -> IoResult<&mut Self>

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

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

impl<'r, E: 'r> RequestBuilder<'r, AsyncRequestBody<'r>, E>

pub fn stream_as_body( &mut self, body: impl AsyncRead + AsyncReset + Unpin + Debug + Send + Sync + 'static, content_length: u64, content_type: Option<Mime>) -> &mut Self

pub fn referenced_stream_as_body<T: AsyncRead + AsyncReset + Unpin + Debug + Send + Sync>( &mut self, body: &'r mut T, content_length: u64, content_type: Option<Mime>) -> &mut Self

pub fn bytes_as_body( &mut self, body: impl Into<Vec<u8>>, content_type: Option<Mime>) -> &mut Self

pub fn referenced_bytes_as_body( &mut self, body: &'r [u8], content_type: Option<Mime>) -> &mut Self

pub fn json(&mut self, body: impl Serialize) -> JsonResult<&mut Self>

pub fn post_form<I, K, V>(&mut self, iter: I) -> &mut Selfwhere I: IntoIterator, I::Item: Borrow<(K, Option<V>)>, K: AsRef<str>, V: AsRef<str>,

pub async fn multipart<'a>( &mut self, multipart: impl Into<AsyncMultipart<'a>>) -> IoResult<&mut RequestBuilder<'r, AsyncRequestBody<'r>, E>>

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

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

Trait Implementations

impl<'r, B: Debug + 'r, E: Debug + 'r> Debug for RequestBuilder<'r, B, E>

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

Auto Trait Implementations

impl<'r, B, E> !RefUnwindSafe for RequestBuilder<'r, B, E>

impl<'r, B, E> Send for RequestBuilder<'r, B, E>where B: Send, E: Send,

impl<'r, B, E> Sync for RequestBuilder<'r, B, E>where B: Sync, E: Sync,

impl<'r, B, E> Unpin for RequestBuilder<'r, B, E>where B: Unpin, E: Unpin,

impl<'r, B, E> !UnwindSafe for RequestBuilder<'r, B, E>

Blanket Implementations

impl<T> Any for Twhere T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for Twhere T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for Twhere T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T> Conv for T

fn conv<T>(self) -> Twhere Self: Into<T>,

impl<T> From<T> for T

fn from(t: T) -> T

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

fn in_current_span(self) -> Instrumented<Self>

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

fn in_current_span(self) -> Instrumented<Self>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

pub fn stream_as_body(
&mut self,
body: impl Read + Reset + Debug + Send + Sync + 'static,
content_length: u64,
content_type: Option<Mime>
) -> &mut Self

pub fn referenced_stream_as_body<T: Read + Reset + Debug + Send + Sync>(
&mut self,
body: &'r mut T,
content_length: u64,
content_type: Option<Mime>
) -> &mut Self

pub fn bytes_as_body(
&mut self,
body: impl Into<Vec<u8>>,
content_type: Option<Mime>
) -> &mut Self

pub fn referenced_bytes_as_body(
&mut self,
body: &'r [u8],
content_type: Option<Mime>
) -> &mut Self

pub fn post_form<I, K, V>(&mut self, iter: I) -> &mut Selfwhere
I: IntoIterator,
I::Item: Borrow<(K, Option<V>)>,
K: AsRef<str>,
V: AsRef<str>,

pub fn multipart<'a>(
&mut self,
multipart: impl Into<SyncMultipart<'a>>
) -> IoResult<&mut Self>

pub fn stream_as_body(
&mut self,
body: impl AsyncRead + AsyncReset + Unpin + Debug + Send + Sync + 'static,
content_length: u64,
content_type: Option<Mime>
) -> &mut Self

pub fn referenced_stream_as_body<T: AsyncRead + AsyncReset + Unpin + Debug + Send + Sync>(
&mut self,
body: &'r mut T,
content_length: u64,
content_type: Option<Mime>
) -> &mut Self

pub fn bytes_as_body(
&mut self,
body: impl Into<Vec<u8>>,
content_type: Option<Mime>
) -> &mut Self

pub fn referenced_bytes_as_body(
&mut self,
body: &'r [u8],
content_type: Option<Mime>
) -> &mut Self

pub fn post_form<I, K, V>(&mut self, iter: I) -> &mut Selfwhere
I: IntoIterator,
I::Item: Borrow<(K, Option<V>)>,
K: AsRef<str>,
V: AsRef<str>,

pub async fn multipart<'a>(
&mut self,
multipart: impl Into<AsyncMultipart<'a>>
) -> IoResult<&mut RequestBuilder<'r, AsyncRequestBody<'r>, E>>

impl<'r, B, E> Send for RequestBuilder<'r, B, E>where
B: Send,
E: Send,

impl<'r, B, E> Sync for RequestBuilder<'r, B, E>where
B: Sync,
E: Sync,

impl<'r, B, E> Unpin for RequestBuilder<'r, B, E>where
B: Unpin,
E: Unpin,

impl<T> Any for Twhere
T: 'static + ?Sized,

impl<T> Borrow<T> for Twhere
T: ?Sized,

impl<T> BorrowMut<T> for Twhere
T: ?Sized,

fn conv<T>(self) -> Twhere
Self: Into<T>,

impl<T, U> Into<U> for Twhere
U: From<T>,

impl<T> Pipe for Twhere
T: ?Sized,

fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,

fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,

fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> Rwhere
Self: Borrow<B>,
B: 'a + ?Sized,
R: 'a,

fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R
) -> Rwhere
Self: BorrowMut<B>,
B: 'a + ?Sized,
R: 'a,

fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> Rwhere
Self: AsRef<U>,
U: 'a + ?Sized,
R: 'a,

fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> Rwhere
Self: AsMut<U>,
U: 'a + ?Sized,
R: 'a,

fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> Rwhere
Self: Deref<Target = T>,
T: 'a + ?Sized,
R: 'a,

fn pipe_deref_mut<'a, T, R>(&'a mut self, func: impl FnOnce(&'a mut T) -> R) -> Rwhere
Self: DerefMut<Target = T> + Deref,
T: 'a + ?Sized,
R: 'a,

fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Selfwhere
Self: Borrow<B>,
B: ?Sized,

fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Selfwhere
Self: BorrowMut<B>,
B: ?Sized,

fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Selfwhere
Self: AsRef<R>,
R: ?Sized,

fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Selfwhere
Self: AsMut<R>,
R: ?Sized,

fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Selfwhere
Self: Deref<Target = T>,
T: ?Sized,

fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Selfwhere
Self: DerefMut<Target = T> + Deref,
T: ?Sized,

fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Selfwhere
Self: Borrow<B>,
B: ?Sized,

fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Selfwhere
Self: BorrowMut<B>,
B: ?Sized,

fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Selfwhere
Self: AsRef<R>,
R: ?Sized,

fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Selfwhere
Self: AsMut<R>,
R: ?Sized,

fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Selfwhere
Self: Deref<Target = T>,
T: ?Sized,

fn tap_deref_mut_dbg<T>(self, func: impl FnOnce(&mut T)) -> Selfwhere
Self: DerefMut<Target = T> + Deref,
T: ?Sized,

fn try_conv<T>(self) -> Result<T, Self::Error>where
Self: TryInto<T>,

impl<T, U> TryFrom<U> for Twhere
U: Into<T>,

impl<T, U> TryInto<U> for Twhere
U: TryFrom<T>,

impl<V, T> VZip<V> for Twhere
V: MultiLane<T>,

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,