Enum hyper::uri::RequestUri [] [src]

pub enum RequestUri {
    AbsolutePath(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

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

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.

The authority form is only for use with CONNECT requests.

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

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
[src]

[src]

Formats the value using the given formatter. Read more

impl PartialEq for RequestUri
[src]

[src]

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

[src]

This method tests for !=.

impl Clone for RequestUri
[src]

[src]

Returns a copy of the value. Read more

1.0.0
[src]

Performs copy-assignment from source. Read more

impl FromStr for RequestUri
[src]

The associated error which can be returned from parsing.

[src]

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

impl Display for RequestUri
[src]

[src]

Formats the value using the given formatter. Read more