Struct Request 

pub struct Request {
    pub method: Vec<u8>,
    pub headers: Headers,
    pub target: Vec<u8>,
    pub http_version: Vec<u8>,
}

HTTP request head event.

Use Request::new or Request::new_http11 for fallible construction. Direct struct literals are possible, but callers should run Request::validate before sending values built from untrusted input.

Fields

method: Vec<u8>

Request method bytes, for example GET or POST.

headers: Headers

Normalized request headers with original casing preserved.

target: Vec<u8>

Request target bytes.

http_version: Vec<u8>

HTTP version without the HTTP/ prefix, for example 1.1.

Implementations

impl Request

pub fn new<M, T, V>( method: M, headers: Headers, target: T, http_version: V, ) -> Result<Self, ProtocolError>

where M: AsRef<[u8]>, T: AsRef<[u8]>, V: AsRef<[u8]>,

Builds and validates a request with an explicit HTTP version.

pub fn new_http11<M, T>( method: M, headers: Headers, target: T, ) -> Result<Self, ProtocolError>

where M: AsRef<[u8]>, T: AsRef<[u8]>,

Builds and validates an HTTP/1.1 request.

pub fn validate(&self) -> Result<(), ProtocolError>

Validates request method, target, HTTP version, and Host header rules.

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Request

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

Formats the value using the given formatter.

impl Default for Request

fn default() -> Request

Returns the “default value” for a type.

impl From<Request> for Event

fn from(request: Request) -> Self

Converts to this type from the input type.

impl PartialEq for Request

fn eq(&self, other: &Request) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Request

impl StructuralPartialEq for Request