Struct TlsConnector 

pub struct TlsConnector(/* private fields */);

Available on crate feature tls only.

A wrapper around a native_tls::TlsConnector or rustls::ClientConfig, providing an async connect method.

Implementations

impl TlsConnector

pub async fn connect<S>( &self, domain: &str, stream: S, ) -> Result<TlsStream<S>, Error>

where S: Splittable + 'static, <S as Splittable>::ReadHalf: AsyncRead + Unpin, <S as Splittable>::WriteHalf: AsyncWrite + Unpin,

Connects the provided stream with this connector, assuming the provided domain.

This function will internally call TlsConnector::connect to connect the stream and returns a future representing the resolution of the connection operation. The returned future will resolve to either TlsStream<S> or Error depending if it’s successful or not.

This is typically used for clients who have already established, for example, a TCP connection to a remote server. That stream is then provided here to perform the client half of a connection to a TLS-powered server.

pub async fn connect_compat<S>( &self, domain: &str, stream: AsyncStream<S>, ) -> Result<TlsStream<S>, Error>

where S: Splittable + 'static, <S as Splittable>::ReadHalf: AsyncRead + Unpin, <S as Splittable>::WriteHalf: AsyncWrite + Unpin,

Similar to connect but accepts an AsyncStream instead of a raw stream. Users are free to adjust the inner buffer sizes and limits.

Trait Implementations

impl Clone for TlsConnector

fn clone(&self) -> TlsConnector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TlsConnector

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

Formats the value using the given formatter.

impl From<Arc<ClientConfig>> for TlsConnector

Available on crate feature rustls only.

fn from(value: Arc<ClientConfig>) -> TlsConnector

Converts to this type from the input type.

impl From<TlsConnector> for TlsConnector

Available on crate feature native-tls only.

fn from(value: TlsConnector) -> TlsConnector

Converts to this type from the input type.