Enum hyper::uri::RequestUri

[+] Show declaration

pub enum RequestUri {
    AbsolutePath(String),
    AbsoluteUri(Url),
    Authority(String),
    Star,
}

[−] Expand description

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(String)

[−] Expand description

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("/where?q=now".to_string()).

AbsoluteUri(Url)

[−] Expand description

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)

[−] Expand description

The authority form is only for use with CONNECT requests.

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

Star

[−] Expand description

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 PartialEq<RequestUri> for RequestUri

[+]

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

[−]

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

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

[−]

This method tests for !=.

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 Debug for RequestUri

[+]

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

[−]

Formats the value using the given formatter.

impl Display for RequestUri

[+]

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

[−]

Formats the value using the given formatter.

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.