[]Enum rocket::http::uri::Uri

pub enum Uri<'a> {
    Origin(Origin<'a>),
    Authority(Authority<'a>),
    Absolute(Absolute<'a>),
    Asterisk,
}

An enum encapsulating any of the possible URI variants.

Usage

In Rocket, this type will rarely be used directly. Instead, you will typically encounter URIs via the Origin type. This is because all incoming requests contain origin-type URIs.

Nevertheless, the Uri type is typically enountered as a conversion target. In particular, you will likely see generic bounds of the form: T: TryInto<Uri> (for instance, in Redirect methods). This means that you can provide any type T that implements TryInto<Uri>, or, equivalently, any type U for which Uri implements TryFrom<U> or From<U>. These include &str and String, Origin, Authority, and Absolute.

Parsing

The Uri type implements a full, zero-allocation, zero-copy RFC 7230 compliant parser. To parse an &str into a Uri, use the Uri::parse() method. Alternatively, you may also use the TryFrom<&str> and TryFrom<String> trait implementation. To inspect the parsed type, match on the resulting enum and use the methods of the internal structure.

Percent Encoding/Decoding

This type also provides the following percent encoding/decoding helper methods: Uri::percent_encode(), Uri::percent_decode(), and Uri::percent_decode_lossy().

Variants

An origin URI.

An authority URI.

An absolute URI.

An asterisk: exactly *.

Methods

impl<'a> Uri<'a>

Parses the string string into a Uri. Parsing will never allocate. Returns an Error if string is not a valid URI.

Example

use rocket::http::uri::Uri;

// Parse a valid origin URI (note: in practice, use `Origin::parse()`).
let uri = Uri::parse("/a/b/c?query").expect("valid URI");
let origin = uri.origin().expect("origin URI");
assert_eq!(origin.path(), "/a/b/c");
assert_eq!(origin.query(), Some("query"));

// Invalid URIs fail to parse.
Uri::parse("foo bar").expect_err("invalid URI");

Returns the internal instance of Origin if self is a Uri::Origin. Otherwise, returns None.

Example

use rocket::http::uri::Uri;

let uri = Uri::parse("/a/b/c?query").expect("valid URI");
assert!(uri.origin().is_some());

let uri = Uri::parse("http://google.com").expect("valid URI");
assert!(uri.origin().is_none());

Returns the internal instance of Authority if self is a Uri::Authority. Otherwise, returns None.

Example

use rocket::http::uri::Uri;

let uri = Uri::parse("user:pass@domain.com").expect("valid URI");
assert!(uri.authority().is_some());

let uri = Uri::parse("http://google.com").expect("valid URI");
assert!(uri.authority().is_none());

Returns the internal instance of Absolute if self is a Uri::Absolute. Otherwise, returns None.

Example

use rocket::http::uri::Uri;

let uri = Uri::parse("http://google.com").expect("valid URI");
assert!(uri.absolute().is_some());

let uri = Uri::parse("/path").expect("valid URI");
assert!(uri.absolute().is_none());

Returns a URL-encoded version of the string. Any characters outside of visible ASCII-range are encoded as well as ' ', '"', '#', '<', '>', '`', '?', '{', '}', '%', '/', '[', '\', ']', '^', and '|'.

Examples

use rocket::http::uri::Uri;

let encoded = Uri::percent_encode("hello?a=<b>hi</b>");
assert_eq!(encoded, "hello%3Fa=%3Cb%3Ehi%3C%2Fb%3E");

Returns a URL-decoded version of the string. If the percent encoded values are not valid UTF-8, an Err is returned.

Examples

use rocket::http::uri::Uri;

let decoded = Uri::percent_decode("/Hello%2C%20world%21".as_bytes());
assert_eq!(decoded.unwrap(), "/Hello, world!");

Returns a URL-decoded version of the path. Any invalid UTF-8 percent-encoded byte sequences will be replaced � U+FFFD, the replacement character.

Examples

use rocket::http::uri::Uri;

let decoded = Uri::percent_decode_lossy("/Hello%2C%20world%21".as_bytes());
assert_eq!(decoded, "/Hello, world!");

Trait Implementations

impl<'a> IntoOwned for Uri<'a>

The owned version of the type.

impl<'a> From<Absolute<'a>> for Uri<'a>

impl<'a> From<Origin<'a>> for Uri<'a>

impl<'a> From<Authority<'a>> for Uri<'a>

impl<'a> PartialEq<Uri<'a>> for Uri<'a>

impl<'a> Clone for Uri<'a>

Performs copy-assignment from source. Read more

impl<'a> Display for Uri<'a>

impl<'a> TryFrom<&'a str> for Uri<'a>

🔬 This is a nightly-only experimental API. (try_from)

The type returned in the event of a conversion error.

impl TryFrom<String> for Uri<'static>

🔬 This is a nightly-only experimental API. (try_from)

The type returned in the event of a conversion error.

impl<'a> Debug for Uri<'a>

Auto Trait Implementations

impl<'a> Send for Uri<'a>

impl<'a> Sync for Uri<'a>

Blanket Implementations

impl<T> From for T
[src]

impl<T> ToString for T where
    T: Display + ?Sized
[src]

impl<T, U> Into for T where
    U: From<T>, 
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

impl<T, U> TryFrom for T where
    T: From<U>, 
[src]

🔬 This is a nightly-only experimental API. (try_from)

The type returned in the event of a conversion error.

impl<T> Borrow for T where
    T: ?Sized
[src]

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T, U> TryInto for T where
    U: TryFrom<T>, 
[src]

🔬 This is a nightly-only experimental API. (try_from)

The type returned in the event of a conversion error.

impl<T> BorrowMut for T where
    T: ?Sized
[src]

impl<T> Typeable for T where
    T: Any

Get the TypeId of this object.

impl<T> IntoCollection for T

impl<T, I> AsResult for T where
    I: Input,