Struct wclient::RequestBuilder

pub struct RequestBuilder { /* fields omitted */ }

Helper builder for Request

• The Request builder has a constructor for each HTTP method (get, post, put, …) and a set of member functions to set the request members.
• A build function creates Request.

use wclient::RequestBuilder;
use json::object;
let data = object! {
   name: "John",
   surname: "Smith"
};
 
let mut request = RequestBuilder::post("Http://web.myservice.com/user")
    .header("Accept", "application/json")
    .param("id", "12345")
    .json(&data)
    .build();

Implementations

impl RequestBuilder

pub fn new(method: HttpMethod, url: &str) -> RequestBuilder

Default constructor

pub fn connect(url: &str) -> RequestBuilder

Creates a CONNECT request builder

pub fn delete(url: &str) -> RequestBuilder

Creates a DELETE request builder

pub fn get(url: &str) -> RequestBuilder

Creates a GET request builder

pub fn head(url: &str) -> RequestBuilder

Creates a HEAD request builder

pub fn options(url: &str) -> RequestBuilder

Creates a OPTIONS request builder

pub fn patch(url: &str) -> RequestBuilder

Creates a PATCH request builder

pub fn post(url: &str) -> RequestBuilder

Creates a POST request builder

pub fn put(url: &str) -> RequestBuilder

Creates a PUT request builder

pub fn trace(url: &str) -> RequestBuilder

Creates a TRACE request builder

pub fn config(self, data: HttpConfig) -> RequestBuilder

Sets the Request configuration

pub fn headers(self, data: HashMap<String, String>) -> RequestBuilder

Adds a set of headers. If there is an existing header with the same key, it is overrriden.

Note: header names are case-insensitive.

pub fn header(self, name: &str, value: &str) -> RequestBuilder

Adds a header. If there is an existing header with the same `name’, it is overrriden.

Note: header names are case-insensitive.

pub fn params(self, data: HashMap<String, String>) -> RequestBuilder

Adds a set of parameters. If there is an existing parameter with the same key, it is overrriden.

Note: parameter names are case-sensitive.

pub fn param(self, name: &str, value: &str) -> RequestBuilder

Adds a parameter. If there is an existing parameter with the same key, it is overrriden.

Note: parameter names are case-sensitive.

pub fn cookies(self, data: HashMap<String, String>) -> RequestBuilder

Adds a set of cookies. If there is an existing cookie with the same key, it is overrriden.

Note: cookie names are case-sensitive.

pub fn cookie(self, name: &str, value: &str) -> RequestBuilder

Adds a cookie. If there is an existing cookie with the same key, it is overrriden.

Note: cookie names are case-sensitive.

pub fn body(self, data: Vec<u8>) -> RequestBuilder

Sets a request body. The Request takes ownership of the data buffer.

pub fn json(self, data: &JsonValue) -> RequestBuilder

Sets a json object as request body. The data object is marshaled into a buffer using UTF8 coding.

pub fn build(self) -> Request

Creates a Request struct.