Struct RequestBuilder 

pub struct RequestBuilder { /* private fields */ }

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<S>(method: HttpMethod, url: S) -> RequestBuilder

where S: Into<String>,

Default constructor

pub fn connect<S>(url: S) -> RequestBuilder

where S: Into<String>,

Creates a CONNECT request builder

pub fn delete<S>(url: S) -> RequestBuilder

where S: Into<String>,

Creates a DELETE request builder

pub fn get<S>(url: S) -> RequestBuilder

where S: Into<String>,

Creates a GET request builder

pub fn head<S>(url: S) -> RequestBuilder

where S: Into<String>,

Creates a HEAD request builder

pub fn options<S>(url: S) -> RequestBuilder

where S: Into<String>,

Creates a OPTIONS request builder

pub fn patch<S>(url: S) -> RequestBuilder

where S: Into<String>,

Creates a PATCH request builder

pub fn post<S>(url: S) -> RequestBuilder

where S: Into<String>,

Creates a POST request builder

pub fn put<S>(url: S) -> RequestBuilder

where S: Into<String>,

Creates a PUT request builder

pub fn trace<S>(url: S) -> RequestBuilder

where S: Into<String>,

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<S>(self, name: S, value: S) -> RequestBuilder

where S: Into<String>,

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<S>(self, name: S, value: S) -> RequestBuilder

where S: Into<String>,

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<S>(self, name: S, value: S) -> RequestBuilder

where S: Into<String>,

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

Note: cookie names are case-sensitive.

pub fn cookie_jar(self, jar: Arc<Mutex<dyn CookieJar>>) -> RequestBuilder

Sets a CookieJar to get/save session cookies

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 auth(self, mgr: Arc<Mutex<dyn AuthManager>>) -> RequestBuilder

Sets Connection Authenticator for 401 Not Authorized responses with WWW-Authenticate headers

pub fn build(self) -> Request

Creates a Request struct.