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 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 AuthorityInputExt for Request

fn authority(&self) -> Option<HostWithOptPort>

The routing authority (host[:port]), or None if none is resolvable.

fn host(&self) -> Option<Host>

The authority Host, dropping any port.

fn host_as_domain(&self) -> Option<Domain>

The authority host as a Domain, or None if absent or not a domain (e.g. an IP literal).

fn port(&self) -> Option<u16>

The authority port, if one is set explicitly.

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 ExtensionsRef for Request

fn extensions(&self) -> &Extensions

Get reference to the underlying Extensions store

impl HttpVersionInputExt for Request

fn http_version(&self) -> Option<Version>

The HTTP version, or None for non-HTTP inputs.

impl ProtocolInputExt for Request

fn protocol(&self) -> Option<Protocol>

The application protocol, or None if it can’t be determined.

fn protocol_default_port(&self) -> Option<u16>

The default port of the resolved Protocol (e.g. 443 for HTTPS), or None if the protocol is unknown or portless.

impl TransportProtocolInputExt for Request

fn transport_protocol(&self) -> TransportProtocol

The transport protocol (TCP or UDP).