Struct http::uri::Parts

pub struct Parts {
    pub scheme: Option<Scheme>,
    pub authority: Option<Authority>,
    pub path_and_query: Option<PathAndQuery>,
    // some fields omitted
}

The various parts of a URI.

This struct is used to provide to and retrieve from a URI.

Fields

scheme: Option<Scheme>

The scheme component of a URI

authority: Option<Authority>

The authority component of a URI

path_and_query: Option<PathAndQuery>

The origin-form component of a URI

Trait Implementations

impl Debug for Parts

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

Formats the value using the given formatter.

impl Default for Parts

fn default() -> Parts

Returns the “default value” for a type.

impl From<Uri> for Parts

Convert a Uri from parts

Examples

Relative URI

let mut parts = Parts::default();
parts.path_and_query = Some("/foo".parse().unwrap());

let uri = Uri::from_parts(parts).unwrap();

assert_eq!(uri.path(), "/foo");

assert!(uri.scheme().is_none());
assert!(uri.authority().is_none());

Absolute URI

let mut parts = Parts::default();
parts.scheme = Some("http".parse().unwrap());
parts.authority = Some("foo.com".parse().unwrap());
parts.path_and_query = Some("/foo".parse().unwrap());

let uri = Uri::from_parts(parts).unwrap();

assert_eq!(uri.scheme().unwrap().as_str(), "http");
assert_eq!(uri.authority().unwrap(), "foo.com");
assert_eq!(uri.path(), "/foo");

fn from(src: Uri) -> Self

Performs the conversion.

impl TryFrom<Parts> for Uri

type Error = InvalidUriParts

The type returned in the event of a conversion error.

fn try_from(src: Parts) -> Result<Self, Self::Error>

Performs the conversion.