Struct Request

pub struct Request<'buf> {
    pub body: Option<&'buf [u8]>,
    pub method: &'buf str,
    pub document: &'buf str,
    pub query_raw: &'buf str,
    pub protocol: &'buf str,
    pub version: &'buf str,
    pub header_raw_lines: Vec<&'buf str>,
    pub peer_addr: Option<SocketAddr>,
    /* private fields */
}

Request contains the request representation that is serialised from the main HTTP request from the socket.

Fields

body: Option<&'buf [u8]>

method: &'buf str

document: &'buf str

query_raw: &'buf str

protocol: &'buf str

version: &'buf str

header_raw_lines: Vec<&'buf str>

peer_addr: Option<SocketAddr>

Implementations

impl<'buf> Request<'buf>

pub fn from_slice(buf: &'buf [u8]) -> Result<Self, RequestError<'buf>>

Construct a new request object using only a slice of u8

pub fn bad() -> Self

Create a default request object for a fail state

pub fn new( buf: &'buf [u8], peer_addr: Option<&SocketAddr>, ) -> Result<Self, RequestError<'buf>>

Construct a new request object, parsing the request buffer

pub fn host(&mut self) -> Option<&'buf str>

pub fn user_agent(&mut self) -> Option<&'buf str>

pub fn content_type(&mut self) -> Option<&'buf str>

pub fn content_length(&mut self) -> Option<usize>

pub fn header(&mut self, key: &str) -> Option<&'buf str>

looks up HTTP headers and returns headers are not parsed until they are needed

pub fn cookie(&mut self, key: &str) -> Option<&Cookie<'buf>>

looks up cookies keys and returns its value cookies are not parsed until they are needed, will parse headers too.

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

looks up get parameters and returns its value will parse all parameters on the first call.

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

looks up post parameters and returns its value will parse the content_type and content_len header on the first call.

Trait Implementations

impl<'buf> Debug for Request<'buf>

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

Formats the value using the given formatter.

impl<'buf> Default for Request<'buf>

fn default() -> Request<'buf>

Returns the “default value” for a type.