Struct Request 

#[non_exhaustive]
pub struct Request {
    pub authority: HostWithPort,
    pub extensions: Extensions,
    pub application_protocol: Option<Protocol>,
    pub transport_protocol: Option<TransportProtocol>,
}

Available on crate feature net only.

A request to establish a Transport (L4) Connection.

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

extensions: Extensions

application_protocol: Option<Protocol>

transport_protocol: Option<TransportProtocol>

Implementations

impl Request

pub fn new(authority: HostWithPort) -> Request

Create a new transport (L4) Request with default Extensions.

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

Create a new transport (L4) Request with given Extensions.

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

Define the application Protocol to this Request requested for this connection.

By default the flow context will define the used application protocol.

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

Define the application Protocol to this Request requested for this connection.

By default the flow context will define the used application protocol.

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

Define the application Protocol to this Request requested for this connection.

By default the flow context will define the used application protocol.

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

Define the application Protocol to this Request requested for this connection.

By default the flow context will define the used application protocol.

pub fn without_application_protocol(self) -> Request

Define the application Protocol to this Request requested for this connection.

By default the flow context will define the used application protocol.

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

Define the application Protocol to this Request requested for this connection.

By default the flow context will define the used application protocol.

pub fn maybe_with_transport_protocol( self, protocol: Option<TransportProtocol>, ) -> Request

Define the TransportProtocol to this Request requested for this connection.

By default it will defined by the flow receiver itself.

pub fn maybe_set_transport_protocol( &mut self, protocol: Option<TransportProtocol>, ) -> &mut Request

Define the TransportProtocol to this Request requested for this connection.

By default it will defined by the flow receiver itself.

pub fn with_transport_protocol(self, protocol: TransportProtocol) -> Request

Define the TransportProtocol to this Request requested for this connection.

By default it will defined by the flow receiver itself.

pub fn set_transport_protocol( &mut self, protocol: TransportProtocol, ) -> &mut Request

Define the TransportProtocol to this Request requested for this connection.

By default it will defined by the flow receiver itself.

pub fn without_transport_protocol(self) -> Request

Define the TransportProtocol to this Request requested for this connection.

By default it will defined by the flow receiver itself.

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

Define the TransportProtocol to this Request requested for this connection.

By default it will defined by the flow receiver itself.

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 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) -> Option<TransportProtocol>

The transport protocol (TCP or UDP).