Module uri

URI component of request and response lines

This module primarily contains the Uri type which is a component of all HTTP requests and also reexports this type at the root of the crate. A URI is not always a “full URL” in the sense of something you’d type into a web browser, but HTTP requests may only have paths on servers but may have full schemes and hostnames on clients.

Examples

use http::Uri;

let uri = "/foo/bar?baz".parse::<Uri>().unwrap();
assert_eq!(uri.path(), "/foo/bar");
assert_eq!(uri.query(), Some("baz"));
assert_eq!(uri.host(), None);

let uri = "https://www.rust-lang.org/install.html".parse::<Uri>().unwrap();
assert_eq!(uri.scheme_str(), Some("https"));
assert_eq!(uri.host(), Some("www.rust-lang.org"));
assert_eq!(uri.path(), "/install.html");

Structs

• Authority
  Represents the authority component of a URI.
• Builder
  A builder for Uris.
• InvalidUri
  An error resulting from a failed attempt to construct a URI.
• InvalidUriParts
  An error resulting from a failed attempt to construct a URI.
• Parts
  The various parts of a URI.
• PathAndQuery
  Represents the path component of a URI
• Port
  The port component of a URI.
• Scheme
  Represents the scheme component of a URI
• Uri
  The URI component of a request.