Struct HttpRequest 

pub struct HttpRequest<'a> {
    pub method: &'a str,
    pub uri: &'a str,
    pub version: &'a str,
    pub headers: Vec<(&'a str, &'a str)>,
    pub body_offset: usize,
}

A parsed HTTP/1.x request.

All string fields are lifetimed references back into the buffer that was passed to HttpRequest::parse. The body_offset field records where the body begins in that same buffer.

Fields

method: &'a str

HTTP method (e.g. "GET", "POST").

uri: &'a str

Request-URI (e.g. "/", "/api/v1/resource").

version: &'a str

HTTP version string (e.g. "HTTP/1.1").

headers: Vec<(&'a str, &'a str)>

Parsed headers as (name, value) pairs. Header names retain their original casing from the wire; callers should compare case-insensitively.

body_offset: usize

Byte offset in the original buffer at which the message body starts. Points to the byte immediately after the blank line (\r\n\r\n) that separates headers from body. When there is no body this equals the buffer length.

Implementations

impl<'a> HttpRequest<'a>

pub fn parse(buf: &'a [u8]) -> Option<Self>

Parse an HTTP/1.x request from buf.

Returns None when:

• the buffer does not start with a known HTTP method, or
• the request line is malformed (missing method / URI / version), or
• the header section is not terminated by \r\n\r\n within buf.

Trait Implementations

impl<'a> Clone for HttpRequest<'a>

fn clone(&self) -> HttpRequest<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for HttpRequest<'a>

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

Formats the value using the given formatter.