Struct Client 

pub struct Client<ReqBody = Body, RespBody = Body> { /* private fields */ }

Available on crate feature client only.

An Client for sending HTTP requests and handling HTTP responses.

Examples

use volo_http::{body::BodyConversion, client::Client};

let client = Client::builder().build().unwrap();
let resp = client
    .get("http://httpbin.org/get")
    .send()
    .await
    .expect("failed to send request")
    .into_string()
    .await
    .expect("failed to convert response to string");
println!("{resp:?}");

Implementations

impl Client

pub fn builder() -> ClientBuilder<Identity, Identity, DefaultMkClient, DefaultLb>

Create a new client builder.

impl<ReqBody, RespBody> Client<ReqBody, RespBody>

pub fn request_builder(&self) -> RequestBuilder<Self>

Create a builder for building a request.

pub fn request<U>(&self, method: Method, uri: U) -> RequestBuilder<Self>

where U: TryInto<Uri>, U::Error: Into<BoxError>,

Create a builder for building a request with the specified method and URI.

pub fn options<U>(&self, uri: U) -> RequestBuilder<Self>

where U: TryInto<Uri>, U::Error: Into<BoxError>,

Create a request with OPTIONS method and the given uri.

pub fn get<U>(&self, uri: U) -> RequestBuilder<Self>

where U: TryInto<Uri>, U::Error: Into<BoxError>,

Create a request with GET method and the given uri.

pub fn post<U>(&self, uri: U) -> RequestBuilder<Self>

where U: TryInto<Uri>, U::Error: Into<BoxError>,

Create a request with POST method and the given uri.

pub fn put<U>(&self, uri: U) -> RequestBuilder<Self>

where U: TryInto<Uri>, U::Error: Into<BoxError>,

Create a request with PUT method and the given uri.

pub fn delete<U>(&self, uri: U) -> RequestBuilder<Self>

where U: TryInto<Uri>, U::Error: Into<BoxError>,

Create a request with DELETE method and the given uri.

pub fn head<U>(&self, uri: U) -> RequestBuilder<Self>

where U: TryInto<Uri>, U::Error: Into<BoxError>,

Create a request with HEAD method and the given uri.

pub fn trace<U>(&self, uri: U) -> RequestBuilder<Self>

where U: TryInto<Uri>, U::Error: Into<BoxError>,

Create a request with TRACE method and the given uri.

pub fn connect<U>(&self, uri: U) -> RequestBuilder<Self>

where U: TryInto<Uri>, U::Error: Into<BoxError>,

Create a request with CONNECT method and the given uri.

pub fn patch<U>(&self, uri: U) -> RequestBuilder<Self>

where U: TryInto<Uri>, U::Error: Into<BoxError>,

Create a request with PATCH method and the given uri.

Trait Implementations

impl<ReqBody, RespBody> Clone for Client<ReqBody, RespBody>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Client

fn default() -> Self

Returns the “default value” for a type.

impl<ReqBody, RespBody> OneShotService<ClientContext, Request<ReqBody>> for Client<ReqBody, RespBody>

where ReqBody: Send,

type Response = Response<RespBody>

Responses given by the service.

type Error = ClientError

Errors produced by the service.

async fn call( self, cx: &mut ClientContext, req: Request<ReqBody>, ) -> Result<Self::Response, Self::Error>

Process the request and return the response asynchronously.

impl<ReqBody, RespBody> Service<ClientContext, Request<ReqBody>> for Client<ReqBody, RespBody>

where ReqBody: Send,

type Response = Response<RespBody>

Responses given by the service.

type Error = ClientError

Errors produced by the service.

fn call( &self, cx: &mut ClientContext, req: Request<ReqBody>, ) -> impl Future<Output = Result<Self::Response, Self::Error>> + Send

Available on crate feature service_send only.

Process the request and return the response asynchronously.