Struct hyper::client::Client [−][src]
pub struct Client<C, B = Body> { /* fields omitted */ }
client
and (crate features http1
or http2
) only.Expand description
A Client to make outgoing HTTP requests.
Client
is cheap to clone and cloning is the recommended way to share a Client
. The
underlying connection pool will be reused.
Implementations
impl Client<HttpConnector, Body>
[src]
impl Client<HttpConnector, Body>
[src]pub fn new() -> 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<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]
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]
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]
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, Method, Client, Request}; let client = Client::new(); let req = Request::builder() .method(Method::POST) .uri("http://httpbin.org/post") .body(Body::from("Hallo!")) .expect("request builder"); let future = client.request(req);
Trait Implementations
impl Default for Client<HttpConnector, Body>
[src]
impl Default for Client<HttpConnector, Body>
[src]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]
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 Future = ResponseFuture
type Future = ResponseFuture
The future response value.
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]
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 Future = ResponseFuture
type Future = ResponseFuture
The future response value.
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,
B: Send,
C: Send,
impl<C, B> Sync for Client<C, B> where
B: Send,
C: Sync,
B: Send,
C: Sync,
impl<C, B> Unpin for Client<C, B> where
C: Unpin,
C: Unpin,
impl<C, B = Body> !UnwindSafe for Client<C, B>
Blanket Implementations
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]pub fn borrow_mut(&mut self) -> &mut T
[src]
pub fn borrow_mut(&mut self) -> &mut T
[src]Mutably borrows from an owned value. Read more
impl<T> Instrument for T
[src]
impl<T> Instrument for T
[src]fn instrument(self, span: Span) -> Instrumented<Self>
[src]
fn instrument(self, span: Span) -> Instrumented<Self>
[src]Instruments this type with the provided Span
, returning an
Instrumented
wrapper. Read more
fn in_current_span(self) -> Instrumented<Self>
[src]
fn in_current_span(self) -> Instrumented<Self>
[src]impl<T> ToOwned for T where
T: Clone,
[src]
impl<T> ToOwned for T where
T: Clone,
[src]type Owned = T
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
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]
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