# Struct hyper::client::Client [−] [src]

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

A Client to make outgoing HTTP requests.

## Implementations

### `impl Client<HttpConnector, Body>` [src]

#### `pub fn new() -> Client<HttpConnector, Body>` [src]

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>` [src]

#### `pub fn builder() -> Builder` [src]

Create a builder to configure a new `Client`.

# Example

    use std::time::Duration;
    use hyper::Client;

    let client = Client::builder()
        .pool_idle_timeout(Duration::from_secs(30))
        .http2_only(true)
        .build_http();

### `impl<C, B> Client<C, B> where
C: Connect + Clone + Send + Sync + 'static,
B: HttpBody + Send + 'static,
B::Data: Send,
B::Error: Into<Box<dyn StdError + Send + Sync>>,` [src]

#### `pub fn get(&self, uri: Uri) -> ResponseFutureⓘ

### Notable traits for ResponseFuture

`impl Future for ResponseFuture type Output = Result<Response<Body>>;`
where
B: Default,` [src]

Send a `GET` request to the supplied `Uri`.

# Note

This requires that the `HttpBody` type have a `Default` implementation. It should return an “empty” version of itself, such that `HttpBody::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ⓘ

### Notable traits for ResponseFuture

`impl Future for ResponseFuture type Output = Result<Response<Body>>;`
` [src]

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://httpbin.org/post")
        .body(Body::from("Hallo!"))
        .expect("request builder");

    let future = client.request(req);

## Trait Implementations

### `impl<C: Clone, B> Clone for Client<C, B>` [src]

#### `fn clone(&self) -> Client<C, B>` [src]

Returns a copy of the value. Read more

#### `pub fn clone_from(&mut self, source: &Self)`1.0.0 [src]

Performs copy-assignment from `source`. Read more

### `impl<C, B> Debug for Client<C, B>` [src]

#### `fn fmt(&self, f: &mut Formatter<'_>) -> Result` [src]

Formats the value using the given formatter. Read more

### `impl Default for Client<HttpConnector, Body>` [src]

#### `fn default() -> Client<HttpConnector, Body>` [src]

Returns the “default value” for a type. Read more

### `impl<C, B> Service<Request<B>> for Client<C, B> where
C: Connect + Clone + Send + Sync + 'static,
B: HttpBody + Send + 'static,
B::Data: Send,
B::Error: Into<Box<dyn StdError + Send + Sync>>,` [src]

#### `type Response = Response<Body>`

Responses given by the service.

#### `type Error = Error`

Errors produced by the service.

#### `type Future = ResponseFuture`

The future response value.

#### `fn poll_ready(&mut self, _: &mut Context<'_>) -> Poll<Result<(), Self::Error>>` [src]

Returns `Poll::Ready(Ok(()))` when the service is able to process requests. Read more

#### `fn call(&mut self, req: Request<B>) -> Self::Future` [src]

Process the request and return the response asynchronously. Read more

### `impl<C, B> Service<Request<B>> for &Client<C, B> where
C: Connect + Clone + Send + Sync + 'static,
B: HttpBody + Send + 'static,
B::Data: Send,
B::Error: Into<Box<dyn StdError + Send + Sync>>,` [src]

#### `type Response = Response<Body>`

Responses given by the service.

#### `type Error = Error`

Errors produced by the service.

#### `type Future = ResponseFuture`

The future response value.

#### `fn poll_ready(&mut self, _: &mut Context<'_>) -> Poll<Result<(), Self::Error>>` [src]

Returns `Poll::Ready(Ok(()))` when the service is able to process requests. Read more

#### `fn call(&mut self, req: Request<B>) -> Self::Future` [src]

Process the request and return the response asynchronously. Read more

## Auto Trait Implementations

### `impl<C, B = Body> !RefUnwindSafe for Client<C, B>`

### `impl<C, B> Send for Client<C, B> where
B: Send,
C: Send,`

### `impl<C, B> Sync for Client<C, B> where
B: Send,
C: Sync,`

### `impl<C, B> Unpin for Client<C, B> where
C: Unpin,`

### `impl<C, B = Body> !UnwindSafe for Client<C, B>`

## Blanket Implementations

### `impl<T> Any for T where
T: 'static + ?Sized,` [src]

#### `pub fn type_id(&self) -> TypeId` [src]

Gets the `TypeId` of `self`. Read more

### `impl<T> Borrow<T> for T where
T: ?Sized,` [src]

#### `pub fn borrow(&self) -> &T` [src]

Immutably borrows from an owned value. Read more

### `impl<T> BorrowMut<T> for T where
T: ?Sized,` [src]

#### `pub fn borrow_mut(&mut self) -> &mut T` [src]

Mutably borrows from an owned value. Read more

### `impl<T> From<T> for T` [src]

#### `pub fn from(t: T) -> T` [src]

Performs the conversion.

### `impl<T> Instrument for T` [src]

#### `pub fn instrument(self, span: Span) -> Instrumented<Self>` [src]

Instruments this type with the provided `Span`, returning an `Instrumented` wrapper. Read more

#### `pub fn in_current_span(self) -> Instrumented<Self>` [src]

Instruments this type with the current `Span`, returning an `Instrumented` wrapper. Read more

### `impl<T, U> Into<U> for T where
U: From<T>,` [src]

#### `pub fn into(self) -> U` [src]

Performs the conversion.

### `impl<T> ToOwned for T where
T: Clone,` [src]

#### `type Owned = T`

The resulting type after obtaining ownership.

#### `pub fn to_owned(&self) -> T` [src]

Creates owned data from borrowed data, usually by cloning. Read more

#### `pub fn clone_into(&self, target: &mut T)` [src]

🔬 This is a nightly-only experimental API. (`toowned_clone_into`)

recently added

Uses borrowed data to replace owned data, usually by cloning. Read more

### `impl<T, U> TryFrom<U> for T where
U: Into<T>,` [src]

#### `type Error = Infallible`

The type returned in the event of a conversion error.

#### `pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>` [src]

Performs the conversion.

### `impl<T, U> TryInto<U> for T where
U: TryFrom<T>,` [src]

#### `type Error = <U as TryFrom<T>>::Error`

The type returned in the event of a conversion error.

#### `pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>` [src]

Performs the conversion.