Enum http_tiny::RequestTarget

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

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

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

Absolute

Fields

path: RequestTargetPath

The path components

query: QueryString

The query string

The requested path

Implementations

impl RequestTarget

pub const fn new_wildcard() -> Self

Creates a new wildcard request target

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

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

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

Loads a request target

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

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.