pub struct Builder { /* private fields */ }
Expand description
A builder for Uri
s.
This type can be used to construct an instance of Uri
through a builder pattern.
Implementations§
source§impl Builder
impl Builder
sourcepub fn new() -> Builder
pub fn new() -> Builder
Creates a new default instance of Builder
to construct a Uri
.
§Examples
let uri = uri::Builder::new()
.scheme("https")
.authority("hyper.rs")
.path_and_query("/")
.build()
.unwrap();
sourcepub fn scheme<T>(self, scheme: T) -> Self
pub fn scheme<T>(self, scheme: T) -> Self
Set the Scheme
for this URI.
§Examples
let mut builder = uri::Builder::new();
builder.scheme("https");
Set the Authority
for this URI.
§Examples
let uri = uri::Builder::new()
.authority("tokio.rs")
.build()
.unwrap();
sourcepub fn path_and_query<T>(self, p_and_q: T) -> Self
pub fn path_and_query<T>(self, p_and_q: T) -> Self
Set the PathAndQuery
for this URI.
§Examples
let uri = uri::Builder::new()
.path_and_query("/hello?foo=bar")
.build()
.unwrap();
sourcepub fn build(self) -> Result<Uri, Error>
pub fn build(self) -> Result<Uri, Error>
Consumes this builder, and tries to construct a valid Uri
from
the configured pieces.
§Errors
This function may return an error if any previously configured argument
failed to parse or get converted to the internal representation. For
example if an invalid scheme
was specified via scheme("!@#%/^")
the error will be returned when this function is called rather than
when scheme
was called.
Additionally, the various forms of URI require certain combinations of parts to be set to be valid. If the parts don’t fit into any of the valid forms of URI, a new error is returned.
§Examples
let uri = Uri::builder()
.build()
.unwrap();