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 method
    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 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", so this trait is not object safe.

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 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 = ()