Enum hyper::RequestUri

pub enum RequestUri {
    AbsolutePath {
        path: String,
        query: Option<String>,
    },
    AbsoluteUri(Url),
    Authority(String),
    Star,
}

The Request-URI of a Request's StartLine.

From Section 5.3, Request Target:

Once an inbound connection is obtained, the client sends an HTTP request message (Section 3) with a request-target derived from the target URI. There are four distinct formats for the request-target, depending on both the method being requested and whether the request is to a proxy.

request-target = origin-form
               / absolute-form
               / authority-form
               / asterisk-form

Variants

AbsolutePath

The most common request target, an absolute path and optional query.

For example, the line GET /where?q=now HTTP/1.1 would parse the URI as AbsolutePath { path: "/where".to_string(), query: Some("q=now".to_string()) }.

Fields

path: String	The path part of the request uri.
query: Option<String>	The query part of the request uri.

AbsoluteUri(Url)

An absolute URI. Used in conjunction with proxies.

When making a request to a proxy, other than a CONNECT or server-wide OPTIONS request (as detailed below), a client MUST send the target URI in absolute-form as the request-target.

An example StartLine with an AbsoluteUri would be GET http://www.example.org/pub/WWW/TheProject.html HTTP/1.1.

Authority(String)

The authority form is only for use with CONNECT requests.

An example StartLine: CONNECT www.example.com:80 HTTP/1.1.

Star

The star is used to target the entire server, instead of a specific resource.

This is only used for a server-wide OPTIONS request.

Trait Implementations

impl Debug for RequestUri

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl PartialEq for RequestUri

fn eq(&self, __arg_0: &RequestUri) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, __arg_0: &RequestUri) -> bool

This method tests for !=.

impl Eq for RequestUri

impl Hash for RequestUri

fn hash<__H: Hasher>(&self, __arg_0: &mut __H)

Feeds this value into the state given, updating the hasher as necessary.

fn hash_slice<H>(data: &[Self], state: &mut H) where H: Hasher

Feeds a slice of this type into the state provided.

impl Clone for RequestUri

fn clone(&self) -> RequestUri

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for RequestUri

fn default() -> RequestUri

Returns the "default value" for a type.

impl FromStr for RequestUri

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<RequestUri, Error>

Parses a string s to return a value of this type.

impl Display for RequestUri

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

Formats the value using the given formatter.