Trait NetworkConnector

pub trait NetworkConnector {
    type Stream: Into<Box<dyn NetworkStream + Send>>;

    // Required method
    fn connect(
        &self,
        host: &str,
        port: u16,
        scheme: &str,
    ) -> Result<Self::Stream>;
}

A connector creates a NetworkStream.

Required Associated Types

type Stream: Into<Box<dyn NetworkStream + Send>>

Type of Stream to create

Required Methods

fn connect(&self, host: &str, port: u16, scheme: &str) -> Result<Self::Stream>

Connect to a remote address.

Implementors

impl NetworkConnector for MockConnector

type Stream = MockStream

impl NetworkConnector for HttpConnector

type Stream = HttpStream

impl<C: NetworkConnector<Stream = S>, S: NetworkStream + Send> NetworkConnector for Pool<C>

type Stream = PooledStream<S>

impl<F> NetworkConnector for F

where F: Fn(&str, u16, &str) -> Result<TcpStream>,

A closure as a connector used to generate TcpStreams per request

Example

Basic example:

Client::with_connector(|addr: &str, port: u16, scheme: &str| {
    TcpStream::connect(&(addr, port))
});

Example using TcpBuilder from the net2 crate if you want to configure your source socket:

Client::with_connector(|addr: &str, port: u16, scheme: &str| {
    let b = TcpBuilder::new_v4());
    b.bind("127.0.0.1:0"));
    b.connect(&(addr, port))
});

type Stream = HttpStream

impl<S: SslClient, C: NetworkConnector<Stream = HttpStream>> NetworkConnector for HttpsConnector<S, C>

type Stream = HttpsStream<<S as SslClient>::Stream>