Struct hyper::client::Client

pub struct Client<C, B = Body> { /* fields omitted */ }

A Client to make outgoing HTTP requests.

Methods

impl Client<HttpConnector, Body>

pub fn new() -> Client<HttpConnector, Body>

Create a new Client with the default config.

Note

The default connector does not handle TLS. Speaking to https destinations will require configuring a connector that implements TLS.

impl Client<(), Body>

pub fn builder() -> Builder

Create a builder to configure a new Client.

Example

use hyper::Client;

let client = Client::builder()
    .keep_alive(true)
    .http2_only(true)
    .build_http();

impl<C, B> Client<C, B> where
    C: Connect + Sync + 'static,
    C::Transport: 'static,
    C::Future: 'static,
    B: Payload + Send + 'static,
    B::Data: Send, 

pub fn get(&self, uri: Uri) -> ResponseFuture where
    B: Default, 

Send a GET request to the supplied Uri.

Note

This requires that the Payload type have a Default implementation. It should return an "empty" version of itself, such that Payload::is_end_stream is true.

Example

use hyper::{Client, Uri};

let client = Client::new();

let future = client.get(Uri::from_static("http://httpbin.org/ip"));

pub fn request(&self, req: Request<B>) -> ResponseFuture

Send a constructed Request using this Client.

Example

use hyper::{Body, Client, Request};

let client = Client::new();

let req = Request::builder()
    .method("POST")
    .uri("http://httpin.org/post")
    .body(Body::from("Hallo!"))
    .expect("request builder");

let future = client.request(req);

Trait Implementations

impl Default for Client<HttpConnector, Body>

fn default() -> Client<HttpConnector, Body>

Returns the "default value" for a type.

impl<C, B> Clone for Client<C, B>

fn clone(&self) -> Client<C, B>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C, B> Debug for Client<C, B>

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

Formats the value using the given formatter.