Struct gotham::test::AsyncTestRequestBuilder [−][src]
pub struct AsyncTestRequestBuilder<'client, C: Connect> { /* fields omitted */ }
Expand description
Builder for a request made with an AsyncTestClient
.
Once a request is fully built, it can be performed using the [perform
] method.
Implementations
Perform the built request.
Convenience method to append a content-type
header for the given MIME type.
Set a Body for this request. See http::request::Builder::body
.
Other than the http::request::Builder::body
it doesn’t finish building
the request though, instead if called multiple times, only the last one is kept.
Defaults to Body::empty
if never called.
Add a custom value to this request. See http::request::Builder::extension
pub fn header<K, V>(self, key: K, value: V) -> Self where
HeaderName: TryFrom<K>,
<HeaderName as TryFrom<K>>::Error: Into<Error>,
HeaderValue: TryFrom<V>,
<HeaderValue as TryFrom<V>>::Error: Into<Error>,
pub fn header<K, V>(self, key: K, value: V) -> Self where
HeaderName: TryFrom<K>,
<HeaderName as TryFrom<K>>::Error: Into<Error>,
HeaderValue: TryFrom<V>,
<HeaderValue as TryFrom<V>>::Error: Into<Error>,
Add a header to this request. See http::request::Builder::header
Set the method of this request. See http::request::Builder::method
Set the Uri
of this request. See http::request::Builder::uri
Set the Version
(HTTP Version) of this Request. http::request::Builder::version
.
Methods from Deref<Target = Builder>
Get the HTTP Method for this request.
By default this is GET
. If builder has error, returns None.
Examples
let mut req = Request::builder();
assert_eq!(req.method_ref(),Some(&Method::GET));
req = req.method("POST");
assert_eq!(req.method_ref(),Some(&Method::POST));
Get the URI for this request
By default this is /
.
Examples
let mut req = Request::builder();
assert_eq!(req.uri_ref().unwrap(), "/" );
req = req.uri("https://www.rust-lang.org/");
assert_eq!(req.uri_ref().unwrap(), "https://www.rust-lang.org/" );
Get the HTTP version for this request
By default this is HTTP/1.1.
Examples
let mut req = Request::builder();
assert_eq!(req.version_ref().unwrap(), &Version::HTTP_11 );
req = req.version(Version::HTTP_2);
assert_eq!(req.version_ref().unwrap(), &Version::HTTP_2 );
Get header on this request builder. when builder has error returns None
Example
let req = Request::builder()
.header("Accept", "text/html")
.header("X-Custom-Foo", "bar");
let headers = req.headers_ref().unwrap();
assert_eq!( headers["Accept"], "text/html" );
assert_eq!( headers["X-Custom-Foo"], "bar" );
Get headers on this request builder.
When builder has error returns None.
Example
let mut req = Request::builder();
{
let headers = req.headers_mut().unwrap();
headers.insert("Accept", HeaderValue::from_static("text/html"));
headers.insert("X-Custom-Foo", HeaderValue::from_static("bar"));
}
let headers = req.headers_ref().unwrap();
assert_eq!( headers["Accept"], "text/html" );
assert_eq!( headers["X-Custom-Foo"], "bar" );
Get a reference to the extensions for this request builder.
If the builder has an error, this returns None
.
Example
let req = Request::builder().extension("My Extension").extension(5u32);
let extensions = req.extensions_ref().unwrap();
assert_eq!(extensions.get::<&'static str>(), Some(&"My Extension"));
assert_eq!(extensions.get::<u32>(), Some(&5u32));
Get a mutable reference to the extensions for this request builder.
If the builder has an error, this returns None
.
Example
let mut req = Request::builder().extension("My Extension");
let mut extensions = req.extensions_mut().unwrap();
assert_eq!(extensions.get::<&'static str>(), Some(&"My Extension"));
extensions.insert(5u32);
assert_eq!(extensions.get::<u32>(), Some(&5u32));
Trait Implementations
Auto Trait Implementations
impl<'client, C> !RefUnwindSafe for AsyncTestRequestBuilder<'client, C>
impl<'client, C> Send for AsyncTestRequestBuilder<'client, C> where
C: Sync,
impl<'client, C> Sync for AsyncTestRequestBuilder<'client, C> where
C: Sync,
impl<'client, C> Unpin for AsyncTestRequestBuilder<'client, C>
impl<'client, C> !UnwindSafe for AsyncTestRequestBuilder<'client, C>
Blanket Implementations
Mutably borrows from an owned value. Read more
pub fn vzip(self) -> V
Attaches the provided Subscriber
to this type, returning a
WithDispatch
wrapper. Read more
Attaches the current default Subscriber
to this type, returning a
WithDispatch
wrapper. Read more