1
0
Fork 0
mirror of https://github.com/actix/actix-web.git synced 2024-12-04 23:36:34 +00:00
actix-web/awc/src/lib.rs

169 lines
4.3 KiB
Rust
Raw Normal View History

2019-03-27 16:24:55 +00:00
//! An HTTP Client
//!
//! ```rust
//! # use futures::future::{Future, lazy};
//! use actix_rt::System;
//! use awc::Client;
//!
//! fn main() {
//! System::new("test").block_on(lazy(|| {
//! let mut client = Client::default();
//!
//! client.get("http://www.rust-lang.org") // <- Create request builder
//! .header("User-Agent", "Actix-web")
//! .send() // <- Send http request
//! .map_err(|_| ())
//! .and_then(|response| { // <- server http response
//! println!("Response: {:?}", response);
//! Ok(())
//! })
//! }));
//! }
//! ```
2019-03-26 04:58:01 +00:00
use std::cell::RefCell;
use std::rc::Rc;
pub use actix_http::client::{ConnectError, InvalidUrl, SendRequestError};
2019-03-27 03:45:00 +00:00
pub use actix_http::error::PayloadError;
2019-03-27 16:24:55 +00:00
pub use actix_http::http;
2019-03-26 04:58:01 +00:00
use actix_http::client::Connector;
use actix_http::http::{HttpTryFrom, Method, Uri};
2019-03-27 16:24:55 +00:00
use actix_http::RequestHead;
2019-03-26 04:58:01 +00:00
mod builder;
mod connect;
mod request;
mod response;
2019-03-27 04:54:57 +00:00
pub mod test;
2019-03-26 04:58:01 +00:00
pub use self::builder::ClientBuilder;
pub use self::request::ClientRequest;
pub use self::response::ClientResponse;
2019-03-26 04:58:01 +00:00
use self::connect::{Connect, ConnectorWrapper};
2019-03-27 16:24:55 +00:00
/// An HTTP Client
2019-03-26 04:58:01 +00:00
///
/// ```rust
/// # use futures::future::{Future, lazy};
/// use actix_rt::System;
/// use awc::Client;
///
/// fn main() {
/// System::new("test").block_on(lazy(|| {
/// let mut client = Client::default();
///
/// client.get("http://www.rust-lang.org") // <- Create request builder
/// .header("User-Agent", "Actix-web")
/// .send() // <- Send http request
/// .map_err(|_| ())
/// .and_then(|response| { // <- server http response
/// println!("Response: {:?}", response);
/// Ok(())
/// })
/// }));
/// }
/// ```
#[derive(Clone)]
pub struct Client {
pub(crate) connector: Rc<RefCell<dyn Connect>>,
}
impl Default for Client {
fn default() -> Self {
Client {
connector: Rc::new(RefCell::new(ConnectorWrapper(
Connector::new().service(),
))),
}
}
}
impl Client {
2019-03-26 16:11:27 +00:00
/// Create new client instance with default settings.
pub fn new() -> Client {
Client::default()
}
2019-03-26 04:58:01 +00:00
/// Build client instance.
pub fn build() -> ClientBuilder {
ClientBuilder::new()
}
/// Construct HTTP request.
pub fn request<U>(&self, method: Method, url: U) -> ClientRequest
where
Uri: HttpTryFrom<U>,
{
ClientRequest::new(method, url, self.connector.clone())
}
2019-03-27 06:25:24 +00:00
/// Create `ClientRequest` from `RequestHead`
///
/// It is useful for proxy requests. This implementation
/// copies all headers and the method.
pub fn request_from<U>(&self, url: U, head: &RequestHead) -> ClientRequest
where
Uri: HttpTryFrom<U>,
{
let mut req =
ClientRequest::new(head.method.clone(), url, self.connector.clone());
for (key, value) in &head.headers {
req.head.headers.insert(key.clone(), value.clone());
}
req
}
2019-03-26 04:58:01 +00:00
pub fn get<U>(&self, url: U) -> ClientRequest
where
Uri: HttpTryFrom<U>,
{
ClientRequest::new(Method::GET, url, self.connector.clone())
}
pub fn head<U>(&self, url: U) -> ClientRequest
where
Uri: HttpTryFrom<U>,
{
ClientRequest::new(Method::HEAD, url, self.connector.clone())
}
pub fn put<U>(&self, url: U) -> ClientRequest
where
Uri: HttpTryFrom<U>,
{
ClientRequest::new(Method::PUT, url, self.connector.clone())
}
pub fn post<U>(&self, url: U) -> ClientRequest
where
Uri: HttpTryFrom<U>,
{
ClientRequest::new(Method::POST, url, self.connector.clone())
}
pub fn patch<U>(&self, url: U) -> ClientRequest
where
Uri: HttpTryFrom<U>,
{
ClientRequest::new(Method::PATCH, url, self.connector.clone())
}
pub fn delete<U>(&self, url: U) -> ClientRequest
where
Uri: HttpTryFrom<U>,
{
ClientRequest::new(Method::DELETE, url, self.connector.clone())
}
pub fn options<U>(&self, url: U) -> ClientRequest
where
Uri: HttpTryFrom<U>,
{
ClientRequest::new(Method::OPTIONS, url, self.connector.clone())
}
}