Struct reqwest::unstable::async::Client

pub struct Client { /* fields omitted */ }

An asynchornous 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

use futures::Future;
use tokio_core::reactor::Core;
use reqwest::unstable::async::Client;

let mut core = Core::new()?;
let client = Client::new(&core.handle());
let fut = client.get("http://httpbin.org/").send();
core.run(fut)?;

Methods

impl Client

fn new(handle: &Handle) -> Client

Constructs a new Client.

Panics

This method panics if native TLS backend cannot be created or initialized. Use Client::builder() if you wish to handle the failure as an Error instead of panicking.

fn builder() -> ClientBuilder

Creates a ClientBuilder to configure a Client.

fn get<U: IntoUrl>(&self, url: U) -> 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) -> 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) -> 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) -> 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) -> 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) -> 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) -> 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) -> Pending

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

fn clone(&self) -> Client

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Client

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

Formats the value using the given formatter.