[−][src]Struct reqwest::async::RequestBuilder
A builder to construct the properties of a Request
.
Methods
impl RequestBuilder
[src]
impl RequestBuilder
pub fn header<K, V>(self, key: K, value: V) -> RequestBuilder where
HeaderName: HttpTryFrom<K>,
HeaderValue: HttpTryFrom<V>,
[src]
pub fn header<K, V>(self, key: K, value: V) -> RequestBuilder where
HeaderName: HttpTryFrom<K>,
HeaderValue: HttpTryFrom<V>,
Add a Header
to this Request.
pub fn headers(self, headers: HeaderMap) -> RequestBuilder
[src]
pub fn headers(self, headers: HeaderMap) -> RequestBuilder
Add a set of Headers to the existing ones on this Request.
The headers will be merged in to any already set.
pub fn basic_auth<U, P>(
self,
username: U,
password: Option<P>
) -> RequestBuilder where
U: Display,
P: Display,
[src]
pub fn basic_auth<U, P>(
self,
username: U,
password: Option<P>
) -> RequestBuilder where
U: Display,
P: Display,
Enable HTTP basic authentication.
pub fn body<T: Into<Body>>(self, body: T) -> RequestBuilder
[src]
pub fn body<T: Into<Body>>(self, body: T) -> RequestBuilder
Set the request body.
pub fn query<T: Serialize + ?Sized>(self, query: &T) -> RequestBuilder
[src]
pub fn query<T: Serialize + ?Sized>(self, query: &T) -> RequestBuilder
Modify the query string of the URL.
Modifies the URL of this request, adding the parameters provided.
This method appends and does not overwrite. This means that it can
be called multiple times and that existing query parameters are not
overwritten if the same key is used. The key will simply show up
twice in the query string.
Calling .query([("foo", "a"), ("foo", "b")])
gives "foo=a&foo=b"
.
Note
This method does not support serializing a single key-value
pair. Instead of using .query(("key", "val"))
, use a sequence, such
as .query(&[("key", "val")])
. It's also possible to serialize structs
and maps into a key-value pair.
Errors
This method will fail if the object you provide cannot be serialized into a query string.
pub fn form<T: Serialize + ?Sized>(self, form: &T) -> RequestBuilder
[src]
pub fn form<T: Serialize + ?Sized>(self, form: &T) -> RequestBuilder
Send a form body.
pub fn json<T: Serialize + ?Sized>(self, json: &T) -> RequestBuilder
[src]
pub fn json<T: Serialize + ?Sized>(self, json: &T) -> RequestBuilder
Send a JSON body.
Errors
Serialization can fail if T
's implementation of Serialize
decides to
fail, or if T
contains a map with non-string keys.
pub fn build(self) -> Result<Request>
[src]
pub fn build(self) -> Result<Request>
Build a Request
, which can be inspected, modified and executed with
Client::execute()
.
pub fn send(self) -> Pending
[src]
pub fn send(self) -> Pending
Constructs the Request and sends it the target URL, returning a Response.
Errors
This method fails if there was an error while sending request, redirect loop was detected or redirect limit was exhausted.
Trait Implementations
impl Debug for RequestBuilder
[src]
impl Debug for RequestBuilder
Auto Trait Implementations
impl Send for RequestBuilder
impl Send for RequestBuilder
impl !Sync for RequestBuilder
impl !Sync for RequestBuilder
Blanket Implementations
impl<T> From for T
[src]
impl<T> From for T
impl<T, U> Into for T where
U: From<T>,
[src]
impl<T, U> Into for T where
U: From<T>,
impl<T, U> TryFrom for T where
T: From<U>,
[src]
impl<T, U> TryFrom for T where
T: From<U>,
type Error = !
try_from
)The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
try_from
)Performs the conversion.
impl<T> Borrow for T where
T: ?Sized,
[src]
impl<T> Borrow for T where
T: ?Sized,
impl<T> BorrowMut for T where
T: ?Sized,
[src]
impl<T> BorrowMut for T where
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
impl<T, U> TryInto for T where
U: TryFrom<T>,
[src]
impl<T, U> TryInto for T where
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
try_from
)The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
try_from
)Performs the conversion.
impl<T> Any for T where
T: 'static + ?Sized,
[src]
impl<T> Any for T where
T: 'static + ?Sized,
fn get_type_id(&self) -> TypeId
[src]
fn get_type_id(&self) -> TypeId
🔬 This is a nightly-only experimental API. (get_type_id
)
this method will likely be replaced by an associated static
Gets the TypeId
of self
. Read more
impl<T> Erased for T
[src]
impl<T> Erased for T