Struct ConnectRequest 

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

Available on crate feature net only.

A protocol-independent request to establish a client 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 ConnectRequest

pub fn new(authority: HostWithPort) -> ConnectRequest

Create a new ConnectRequest with default Extensions.

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

Create a new ConnectRequest with given Extensions.

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

Define the application Protocol to this ConnectRequest 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 ConnectRequest

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

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

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

Define the application Protocol to this ConnectRequest 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 ConnectRequest

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

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

pub fn without_application_protocol(self) -> ConnectRequest

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

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

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

Define the application Protocol to this ConnectRequest 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>, ) -> ConnectRequest

Define the TransportProtocol to this ConnectRequest 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 ConnectRequest

Define the TransportProtocol to this ConnectRequest requested for this connection.

By default it will defined by the flow receiver itself.

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

Define the TransportProtocol to this ConnectRequest requested for this connection.

By default it will defined by the flow receiver itself.

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

Define the TransportProtocol to this ConnectRequest requested for this connection.

By default it will defined by the flow receiver itself.

pub fn without_transport_protocol(self) -> ConnectRequest

Define the TransportProtocol to this ConnectRequest requested for this connection.

By default it will defined by the flow receiver itself.

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

Define the TransportProtocol to this ConnectRequest requested for this connection.

By default it will defined by the flow receiver itself.

Trait Implementations

impl AuthorityInputExt for ConnectRequest

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 ConnectRequest

fn clone(&self) -> ConnectRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConnectRequest

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

Formats the value using the given formatter.

impl ExtensionsRef for ConnectRequest

fn extensions(&self) -> &Extensions

Get reference to the underlying Extensions store

impl Fork for ConnectRequest

fn fork(&self) -> ConnectRequest

Create a structurally isolated logical child of this value.

impl HttpVersionInputExt for ConnectRequest

Available on crate feature http only.

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

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

impl ProtocolInputExt for ConnectRequest

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<S, P> Service<ConnectRequest> for SystemProxyConnectService<S, P>

where S: Service<ConnectRequest>, <S as Service<ConnectRequest>>::Error: Into<Box<dyn Error + Send + Sync>>, P: SystemProxyPacService,

type Output = <S as Service<ConnectRequest>>::Output

The type of the output returned by the service.

type Error = Box<dyn Error + Send + Sync>

The type of error returned by the service.

async fn serve( &self, input: ConnectRequest, ) -> Result<<SystemProxyConnectService<S, P> as Service<ConnectRequest>>::Output, <SystemProxyConnectService<S, P> as Service<ConnectRequest>>::Error>

Serve an output or an error for the given input

fn boxed(self) -> BoxService<Input, Self::Output, Self::Error>

Box this service to allow for dynamic dispatch.

impl TargetHttpVersionInputExt for ConnectRequest

Available on crate feature http only.

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

The selected egress HTTP version, or None if none is available.

fn target_http_version_with_fallback( &self, fallback: Option<Version>, ) -> Option<Version>

Resolve the selected egress HTTP version with a post-negotiation fallback.

impl TransportProtocolInputExt for ConnectRequest

fn transport_protocol(&self) -> Option<TransportProtocol>

The transport protocol (TCP or UDP).