Struct reqwest::Client
[−]
[src]
pub struct Client { /* fields omitted */ }
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.
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]
fn new() -> Result<Client>
Constructs a new Client
.
Errors
This method fails if native TLS backend cannot be created or initialized.
fn builder() -> Result<ClientBuilder>
Creates a ClientBuilder
to configure a Client
.
Errors
This method fails if native TLS backend cannot be created.
fn get<U: IntoUrl>(&self, url: U) -> Result<RequestBuilder>
Convenience method to make a GET
request to a URL.
Errors
This method fails whenever supplied Url
cannot be parsed.
fn post<U: IntoUrl>(&self, url: U) -> Result<RequestBuilder>
Convenience method to make a POST
request to a URL.
Errors
This method fails whenever supplied Url
cannot be parsed.
fn put<U: IntoUrl>(&self, url: U) -> Result<RequestBuilder>
Convenience method to make a PUT
request to a URL.
Errors
This method fails whenever supplied Url
cannot be parsed.
fn patch<U: IntoUrl>(&self, url: U) -> Result<RequestBuilder>
Convenience method to make a PATCH
request to a URL.
Errors
This method fails whenever supplied Url
cannot be parsed.
fn delete<U: IntoUrl>(&self, url: U) -> Result<RequestBuilder>
Convenience method to make a DELETE
request to a URL.
Errors
This method fails whenever supplied Url
cannot be parsed.
fn head<U: IntoUrl>(&self, url: U) -> Result<RequestBuilder>
Convenience method to make a HEAD
request to a URL.
Errors
This method fails whenever supplied Url
cannot be parsed.
fn request<U: IntoUrl>(&self, method: Method, url: U) -> Result<RequestBuilder>
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.
fn execute(&self, request: Request) -> Result<Response>
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
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0
Performs copy-assignment from source
. Read more