Enum http_header::RequestTarget

pub enum RequestTarget {
    Wildcard,
    Absolute {
        path: RequestTargetPath,
        query: QueryString,
    },
}

👎 Deprecated:

This crate has been renamed to http_tiny; you’re using an outdated version

A request target (see https://tools.ietf.org/html/rfc7230#section-5.3)

Note

We only support the absolute and the asterisk form.

Warning

The path parser is pretty simple and basically follows two rules only:

• the path must either be a wildcard (*) or must begin with a slash (/)
• empty path components are ignored (i.e. /, // evaluate to [] and /test//path, /test//path/ etc. evaluate to ["test", "path"])

Other potentially dangerous components like .. are treated like normal components and do not cause an error.

Warning

The query parser is also pretty simple and basically parses any key or key= or key=value component without further validation (with the excepttion that the URI escaping must be valid if present).

The following rules apply:

• the query string must begin with a ?
• keys don’t need a value (e.g. ?key0&key1)
• keys can have an empty value (e.g. ?key0=&key1=)
• keys can have a non-empty value (e.g. ?key0=value0&key1=value1
• empty keys or key-value pairs are ignored (i.e. ?& evaluates to [] or ?key0&&key1 evaluates to ["key0": "", "key1": ""] or ?=value0&key1=value1& evaluates to ["key1": "value1"])

Variants

Wildcard

👎 Deprecated:

This crate has been renamed to http_tiny; you’re using an outdated version

The requested path is a wildcard (“*” e.g. for OPTIONS requests)

Absolute

👎 Deprecated:

This crate has been renamed to http_tiny; you’re using an outdated version

The requested path

Fields of Absolute

path: RequestTargetPath

👎 Deprecated:

This crate has been renamed to http_tiny; you’re using an outdated version

The path components

query: QueryString

👎 Deprecated:

This crate has been renamed to http_tiny; you’re using an outdated version

The query string

Implementations

impl RequestTarget

pub const fn new_wildcard() -> Self

👎 Deprecated:

This crate has been renamed to http_tiny; you’re using an outdated version

Creates a new wildcard request target

pub const fn new_absolute(path: RequestTargetPath, query: QueryString) -> Self

👎 Deprecated:

This crate has been renamed to http_tiny; you’re using an outdated version

Creates a new request target from the given path and query components

pub fn read<T>(source: &mut T) -> Result<Self> where
    T: BufRead, 

👎 Deprecated:

This crate has been renamed to http_tiny; you’re using an outdated version

Loads a request target

pub fn write<T>(self, output: &mut T) -> Result where
    T: Write, 

👎 Deprecated:

This crate has been renamed to http_tiny; you’re using an outdated version

Writes the request target

Trait Implementations

impl Clone for RequestTarget

fn clone(&self) -> RequestTarget

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RequestTarget

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

Formats the value using the given formatter.