Struct Request

pub struct Request<'a, T = Vec<&'static [u8]>> {
    pub method: Method,
    pub url: &'a str,
    pub body: T,
    pub deadline: Option<Timestamp>,
    /* private fields */
}

An HTTP request builder.

Fields

method: Method

Request method

url: &'a str

Request URL

body: T

Body of the request

deadline: Option<Timestamp>

Deadline to finish sending the request

Implementations

impl<'a> Request<'a>

pub fn get(url: &'a str) -> Self

Start a simple GET request

impl<'a, T> Request<'a, T>

pub fn post(url: &'a str, body: T) -> Self

Create new POST request with given body.

impl<'a, T: Default> Request<'a, T>

pub fn new(url: &'a str) -> Self

Create a new Request builder with the given URL.

pub fn method(self, method: Method) -> Self

Change the method of the request

pub fn url(self, url: &'a str) -> Self

Change the URL of the request.

pub fn body(self, body: T) -> Self

Set the body of the request.

pub fn add_header(self, name: &str, value: &str) -> Self

Add a header.

pub fn deadline(self, deadline: Timestamp) -> Self

Set the deadline of the request.

impl<'a, I: AsRef<[u8]>, T: IntoIterator<Item = I>> Request<'a, T>

pub fn send(self) -> Result<PendingRequest, HttpError>

Send the request and return a handle.

Err is returned in case the deadline is reached or the request timeouts.

Trait Implementations

impl<'a, T: Clone> Clone for Request<'a, T>

fn clone(&self) -> Request<'a, T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, T> Debug for Request<'a, T>

where T: Debug,

fn fmt(&self, fmt: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Default> Default for Request<'static, T>

fn default() -> Self

Returns the “default value” for a type.

impl<'a, T: PartialEq> PartialEq for Request<'a, T>

fn eq(&self, other: &Request<'a, T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a, T: Eq> Eq for Request<'a, T>

impl<'a, T> StructuralPartialEq for Request<'a, T>