[−][src]Struct reqwest::Client
A Client
to make Requests with.
The Client has various configuration values to tweak, but the defaults
are set to what is usually the most commonly desired value. To configure a
Client
, use Client::builder()
.
The Client
holds a connection pool internally, so it is advised that
you create one and reuse it.
Examples
let client = Client::new(); let resp = client.get("http://httpbin.org/").send()?;
Methods
impl Client
[src]
pub fn new() -> Client
[src]
Constructs a new Client
.
Panic
This method panics if TLS backend cannot initialized, or the resolver cannot load the system configuration.
Use Client::builder()
if you wish to handle the failure as an Error
instead of panicking.
pub fn builder() -> ClientBuilder
[src]
Creates a ClientBuilder
to configure a Client
.
This is the same as ClientBuilder::new()
.
pub fn get<U: IntoUrl>(&self, url: U) -> RequestBuilder
[src]
Convenience method to make a GET
request to a URL.
Errors
This method fails whenever supplied Url
cannot be parsed.
pub fn post<U: IntoUrl>(&self, url: U) -> RequestBuilder
[src]
Convenience method to make a POST
request to a URL.
Errors
This method fails whenever supplied Url
cannot be parsed.
pub fn put<U: IntoUrl>(&self, url: U) -> RequestBuilder
[src]
Convenience method to make a PUT
request to a URL.
Errors
This method fails whenever supplied Url
cannot be parsed.
pub fn patch<U: IntoUrl>(&self, url: U) -> RequestBuilder
[src]
Convenience method to make a PATCH
request to a URL.
Errors
This method fails whenever supplied Url
cannot be parsed.
pub fn delete<U: IntoUrl>(&self, url: U) -> RequestBuilder
[src]
Convenience method to make a DELETE
request to a URL.
Errors
This method fails whenever supplied Url
cannot be parsed.
pub fn head<U: IntoUrl>(&self, url: U) -> RequestBuilder
[src]
Convenience method to make a HEAD
request to a URL.
Errors
This method fails whenever supplied Url
cannot be parsed.
pub fn request<U: IntoUrl>(&self, method: Method, url: U) -> RequestBuilder
[src]
Start building a Request
with the Method
and Url
.
Returns a RequestBuilder
, which will allow setting headers and
request body before sending.
Errors
This method fails whenever supplied Url
cannot be parsed.
pub fn execute(&self, request: Request) -> Result<Response>
[src]
Executes a Request
.
A Request
can be built manually with Request::new()
or obtained
from a RequestBuilder with RequestBuilder::build()
.
You should prefer to use the RequestBuilder
and
RequestBuilder::send()
.
Errors
This method fails if there was an error while sending request, redirect loop was detected or redirect limit was exhausted.
Trait Implementations
impl Clone for Client
[src]
fn clone(&self) -> Client
[src]
fn clone_from(&mut self, source: &Self)
1.0.0[src]
Performs copy-assignment from source
. Read more
impl Debug for Client
[src]
Auto Trait Implementations
impl Unpin for Client
impl Sync for Client
impl Send for Client
impl !UnwindSafe for Client
impl !RefUnwindSafe for Client
Blanket Implementations
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
fn to_owned(&self) -> T
[src]
fn clone_into(&self, target: &mut T)
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,