Struct async_web_server::HttpRequest

pub struct HttpRequest<IO: AsyncRead + AsyncWrite + Unpin = TcpOrTlsStream> { /* private fields */ }

Implementations

impl<IO: AsyncRead + AsyncWrite + Unpin> HttpRequest<IO>

pub fn into_inner( self ) -> Request<BodyDecodeWithContinue<BodyDecodeWithContinueState, IO>>

Direct access to the request as http::Request with body decoder and underlying transport. The transport may be extracted using

let transport = request.into_inner();

Doing this after starting to read the body may lead to one of these situations:

• The meaning of remaining data read from the transport is ambiguous, if the body has been partially consumed and is encoded using chunked transfer encoding.
• If the request includes the Expect: 100-continue header and if the body reader has been polled, but did not yield any data yet, the informational response 100 Continue may have been fully, partially or not sent on the transport.

Reasoning about the protocol state is only trivial before calling Self::body() and after consuming the whole body.

pub fn from_inner( request: Request<BodyDecodeWithContinue<BodyDecodeWithContinueState, IO>> ) -> Self

The inverse of Self::into_inner().

pub async fn response(self) -> Result<HttpResponse<IO>>

Move on to responding after consuming and discarding the remaining request body data.

pub fn body( &mut self ) -> BodyDecodeWithContinue<&mut BodyDecodeWithContinueState, &mut IO>

Access the request body data stream as [futures::io::AsyncRead]. If the request includes the Expect: 100-continue the informational response 100 Continue will be sent to the client before the reader emits any body data.

pub async fn body_string(&mut self) -> Result<String>

Read whole body as String. See Self::body for details.

pub async fn body_vec(&mut self) -> Result<Vec<u8>>

Read whole body as Vec. See Self::body for details.

pub fn headers(&self) -> &HeaderMap

Access the headers as http::HeaderMap.

pub fn uri(&self) -> &Uri

Access the URI as http::Uri.

pub fn method(&self) -> Method

Return the method as http::Method.

pub fn version(&self) -> Version

Return the HTTP version as http::Version.

Trait Implementations

impl<IO: AsyncRead + AsyncWrite + Unpin + IsTls> IsTls for HttpRequest<IO>

fn is_tls(&self) -> bool