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>(&mut self, scheme: T) -> &mut Builderwhere
Scheme: HttpTryFrom<T>,
pub fn scheme<T>(&mut self, scheme: T) -> &mut Builderwhere
Scheme: HttpTryFrom<T>,
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>(&mut self, p_and_q: T) -> &mut Builderwhere
PathAndQuery: HttpTryFrom<T>,
pub fn path_and_query<T>(&mut self, p_and_q: T) -> &mut Builderwhere
PathAndQuery: HttpTryFrom<T>,
Set the PathAndQuery
for this URI.
Examples
let uri = uri::Builder::new()
.path_and_query("/hello?foo=bar")
.build()
.unwrap();
sourcepub fn build(&mut self) -> Result<Uri, Error>
pub fn build(&mut 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();
Trait Implementations§
Auto Trait Implementations§
impl RefUnwindSafe for Builder
impl Send for Builder
impl Sync for Builder
impl Unpin for Builder
impl UnwindSafe for Builder
Blanket Implementations§
source§impl<T> IntoSql for T
impl<T> IntoSql for T
source§fn into_sql<T>(self) -> Self::Expressionwhere
Self: AsExpression<T> + Sized,
fn into_sql<T>(self) -> Self::Expressionwhere
Self: AsExpression<T> + Sized,
self
to an expression for Diesel’s query builder. Read moresource§fn as_sql<'a, T>(&'a self) -> <&'a Self as AsExpression<T>>::Expressionwhere
&'a Self: AsExpression<T>,
fn as_sql<'a, T>(&'a self) -> <&'a Self as AsExpression<T>>::Expressionwhere
&'a Self: AsExpression<T>,
&self
to an expression for Diesel’s query builder. Read more