Struct Request

pub struct Request<'a> { /* private fields */ }

Implementations

impl<'a> Request<'a>

pub fn get_header(&self, key: &str) -> Option<&str>

Get the value of a header pair by specifying the key For example, Content-length: 123 get_header(“Content-length”), the key is not case senstive

pub fn get_param(&self, k: &str) -> Option<&str>

Get the value of a parameter in the requested url

For example

/path?id=1

• get_param("id") returns 1, the key is case senstive

pub fn get_params(&self) -> Option<HashMap<&str, &str>>

Get the HashMap of the parameters in the requested url

For example

/path?id=1&flag=true

• get_params() returns {id:1, flag:true }

pub fn get_headers(&self) -> HashMap<&str, &str>

Get the complete http headers

• {"Content-length":"1", "key":"value",...}

pub fn get_version(&self) -> &str

Get the version of http request

pub fn get_query(&self, k: &str) -> Option<&str>

Query the value of www-form-urlencoded or the text part of the multipart-form

• The key is not case senstive

For example

Assume the form has the value id=1, then get_query(“id”) returns Some(“1”)

pub fn get_file(&self, k: &str) -> Option<&MultipleFormFile>

This method is used to acquire the file in the multipart-form data

For example,

<form>
   <input type="file" name="file1" />
</form>

• get_file("file1") return the file’s meta data

pub fn get_queries(&self) -> Option<HashMap<&str, &str>>

Return a HashMap that comprises all pairs in the www-form-urlencoded or the text part of the multipart-form

• It is safety called even though the request is GET, which returns None

pub fn get_files(&self) -> Option<Vec<&MultipleFormFile>>

Returns an array comprises of all files in the multipart-form data

pub fn plain_body(&self) -> Option<&str>

Returns the body of a request

• it is used for getting the posted JSON or other plain text body

pub fn has_body(&self) -> bool

Determin whether the request has a body

pub fn get_conn(&self) -> Rc<RefCell<&'a mut TcpStream>>

Return the raw instance of TcpStream

• This method should be carefully used, It is better to only get some meta information of a connection, such as a peer IP

pub fn get_method(&self) -> &str

Return the requested http method

pub fn get_url(&self) -> &str

Return the complete requested url

pub fn url_to_path(&self) -> &str

Return the part of url exclude the parameters(if any)

pub fn get_context(&self) -> &RefCell<BTreeMap<String, Value>>

It is used to store user data

• share data between middlwares and routers(if any)