Struct Request 

#[non_exhaustive]
pub struct Request {
    pub authority: HostWithPort,
    pub protocol: Option<Protocol>,
    pub http_version: Option<Version>,
    pub extensions: Extensions,
}

Available on crate feature tcp only.

A request to establish a Tcp Connection.

This can be used in case you operate on a layer below an application layer such as Http.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

authority: HostWithPort

protocol: Option<Protocol>

http_version: Option<Version>

extensions: Extensions

Implementations

impl Request

pub const fn new(authority: HostWithPort) -> Request

Create a new Tcp Request with default Extensions.

pub const fn new_with_extensions( authority: HostWithPort, extensions: Extensions, ) -> Request

Create a new Tcp Request with given Extensions.

pub fn maybe_with_protocol(self, protocol: Option<Protocol>) -> Request

Define the application protocol to this Request on which the established connection will operate.

pub fn maybe_set_protocol(&mut self, protocol: Option<Protocol>) -> &mut Request

Define the application protocol to this Request on which the established connection will operate.

pub fn with_protocol(self, protocol: Protocol) -> Request

Define the application protocol to this Request on which the established connection will operate.

pub fn set_protocol(&mut self, protocol: Protocol) -> &mut Request

Define the application protocol to this Request on which the established connection will operate.

pub fn without_protocol(self) -> Request

Define the application protocol to this Request on which the established connection will operate.

pub fn unset_protocol(&mut self) -> &mut Request

Define the application protocol to this Request on which the established connection will operate.

pub fn maybe_with_http_version(self, version: Option<Version>) -> Request

Define the http version as a hint to the application layer.

pub fn maybe_set_http_version( &mut self, version: Option<Version>, ) -> &mut Request

Define the http version as a hint to the application layer.

pub fn with_http_version(self, version: Version) -> Request

Define the http version as a hint to the application layer.

pub fn set_http_version(&mut self, version: Version) -> &mut Request

Define the http version as a hint to the application layer.

pub fn without_http_version(self) -> Request

Define the http version as a hint to the application layer.

pub fn unset_http_version(&mut self) -> &mut Request

Define the http version as a hint to the application layer.

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Request

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl ExtensionsMut for Request

fn extensions_mut(&mut self) -> &mut Extensions

Get mutable reference to the underlying Extensions store

fn take_extensions(&mut self) -> Extensions

impl ExtensionsRef for Request

fn extensions(&self) -> &Extensions

Get reference to the underlying Extensions store

impl From<&Request> for TransportContext

fn from(value: &Request) -> TransportContext

Converts to this type from the input type.

impl From<Request> for TransportContext

fn from(value: Request) -> TransportContext

Converts to this type from the input type.

impl TryRefIntoTransportContext for Request

type Error = Infallible

The error that can happen when trying to turn the self reference into the TransportContext.

fn try_ref_into_transport_ctx( &self, ) -> Result<TransportContext, <Request as TryRefIntoTransportContext>::Error>

Try to turn the reference to self within the given context into the TransportContext.