Trait Connector 

pub trait Connector:
    Send
    + Sync
    + 'static {
    type Transport: Transport;
    type Runtime: RuntimeTrait;
    type Udp: UdpTransport;

    // Required methods
    fn connect(
        &self,
        url: &Url,
    ) -> impl Future<Output = Result<Self::Transport, Error>> + Send;
    fn resolve(
        &self,
        host: &str,
        port: u16,
    ) -> impl Future<Output = Result<Vec<SocketAddr>, Error>> + Send;
    fn runtime(&self) -> Self::Runtime;

    // Provided methods
    fn connect_to(
        &self,
        destination: Destination,
    ) -> impl Future<Output = Result<Self::Transport, Error>> + Send { ... }
    fn arced(self) -> ArcedConnector
       where Self: Sized { ... }
}

Interface for runtime and tls adapters for the trillium client

See trillium_client for more information on usage.

Required Associated Types

type Transport: Transport

the Transport that connect returns

type Runtime: RuntimeTrait

The RuntimeTrait for this Connector

type Udp: UdpTransport

The async UDP socket type for this connector. Used by QUIC adapters for HTTP/3 support. Connectors that do not support UDP should set this to ().

Required Methods

fn connect( &self, url: &Url, ) -> impl Future<Output = Result<Self::Transport, Error>> + Send

Initiate a connection to the provided url

fn resolve( &self, host: &str, port: u16, ) -> impl Future<Output = Result<Vec<SocketAddr>, Error>> + Send

Perform a DNS lookup for a given host-and-port

fn runtime(&self) -> Self::Runtime

Returns the runtime

Provided Methods

fn connect_to( &self, destination: Destination, ) -> impl Future<Output = Result<Self::Transport, Error>> + Send

Open a connection to destination: dialing its pre-resolved addresses if present, otherwise resolving its host, and advertising any per-connection ALPN it carries.

A domain destination keeps its host as the certificate identity (SNI) regardless of the addresses dialed, so pre-resolved addresses may come from any resolver (e.g. a DNS cache) without affecting certificate validation.

The default implementation reconstructs a URL via Destination::to_url and calls connect, which ignores pre-resolved addresses and per-connection ALPN; connectors that honor those override this method.

destination is taken by value so connectors can adjust it (e.g. clearing secure before delegating the TCP dial to an inner connector) without copying. A caller that needs to retain it should clone before calling.

fn arced(self) -> ArcedConnector

where Self: Sized,

Returns an object-safe ArcedConnector. Do not implement this.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementations on Foreign Types

impl Connector for ClientConfig

type Runtime = SmolRuntime

type Transport = SmolTransport<TcpStream>

type Udp = SmolUdpSocket

fn runtime(&self) -> <ClientConfig as Connector>::Runtime

async fn connect( &self, url: &Url, ) -> Result<<ClientConfig as Connector>::Transport, Error>

async fn connect_to( &self, destination: Destination, ) -> Result<<ClientConfig as Connector>::Transport, Error>

async fn resolve(&self, host: &str, port: u16) -> Result<Vec<SocketAddr>, Error>

impl Connector for SmolTransport<UnixStream>

Available on Unix only.

type Runtime = SmolRuntime

type Transport = SmolTransport<UnixStream>

type Udp = SmolUdpSocket

async fn connect( &self, _url: &Url, ) -> Result<<SmolTransport<UnixStream> as Connector>::Transport, Error>

fn runtime(&self) -> <SmolTransport<UnixStream> as Connector>::Runtime

async fn resolve( &self, _host: &str, _port: u16, ) -> Result<Vec<SocketAddr>, Error>

Implementors

impl Connector for ArcedConnector

type Runtime = Runtime

type Transport = Box<dyn Transport>

type Udp = ()

impl Connector for RuntimelessClientConfig

type Runtime = RuntimelessRuntime

type Transport = TestTransport

type Udp = ()

impl<H: Handler> Connector for ServerConnector<H>

type Runtime = Runtime

type Transport = TestTransport

type Udp = ()