Struct HttpConnector

pub struct HttpConnector<R = GaiResolver> { /* private fields */ }

A connector for the http scheme.

Performs DNS resolution in a thread pool, and then connects over TCP.

Note

Sets the HttpInfo value on responses, which includes transport information such as the remote socket address used.

Implementations

impl HttpConnector

pub fn new(threads: usize) -> HttpConnector

Construct a new HttpConnector.

Takes number of DNS worker threads.

pub fn new_with_executor<E>( executor: E, handle: Option<Handle>, ) -> HttpConnector

where E: 'static + Executor<GaiTask> + Send + Sync,

Construct a new HttpConnector.

Takes an executor to run blocking getaddrinfo tasks on.

impl HttpConnector<TokioThreadpoolGaiResolver>

pub fn new_with_tokio_threadpool_resolver() -> HttpConnector<TokioThreadpoolGaiResolver>

Construct a new HttpConnector using the TokioThreadpoolGaiResolver.

This resolver requires the threadpool runtime to be used.

impl<R> HttpConnector<R>

pub fn new_with_resolver(resolver: R) -> HttpConnector<R>

Construct a new HttpConnector.

Takes a Resolve to handle DNS lookups.

pub fn enforce_http(&mut self, is_enforced: bool)

Option to enforce all Uris have the http scheme.

Enabled by default.

pub fn set_reactor(&mut self, handle: Option<Handle>)

Set a handle to a Reactor to register connections to.

If None, the implicit default reactor will be used.

pub fn set_keepalive(&mut self, dur: Option<Duration>)

Set that all sockets have SO_KEEPALIVE set with the supplied duration.

If None, the option will not be set.

Default is None.

pub fn set_nodelay(&mut self, nodelay: bool)

Set that all sockets have SO_NODELAY set to the supplied value nodelay.

Default is false.

pub fn set_send_buffer_size(&mut self, size: Option<usize>)

Sets the value of the SO_SNDBUF option on the socket.

pub fn set_recv_buffer_size(&mut self, size: Option<usize>)

Sets the value of the SO_RCVBUF option on the socket.

pub fn set_local_address(&mut self, addr: Option<IpAddr>)

Set that all sockets are bound to the configured address before connection.

If None, the sockets will not be bound.

Default is None.

pub fn set_resolve_timeout(&mut self, dur: Option<Duration>)

Set timeout for hostname resolution.

If None, then no timeout is applied by the connector, making it subject to the timeout imposed by the operating system.

Default is None.

pub fn set_connect_timeout(&mut self, dur: Option<Duration>)

Set the connect timeout.

If a domain resolves to multiple IP addresses, the timeout will be evenly divided across them.

Default is None.

pub fn set_happy_eyeballs_timeout(&mut self, dur: Option<Duration>)

Set timeout for RFC 6555 (Happy Eyeballs) algorithm.

If hostname resolves to both IPv4 and IPv6 addresses and connection cannot be established using preferred address family before timeout elapses, then connector will in parallel attempt connection using other address family.

If None, parallel connection attempts are disabled.

Default is 300 milliseconds.

pub fn set_reuse_address( &mut self, reuse_address: bool, ) -> &mut HttpConnector<R>

Set that all socket have SO_REUSEADDR set to the supplied value reuse_address.

Default is false.

Trait Implementations

impl<R> Clone for HttpConnector<R>

where R: Clone,

fn clone(&self) -> HttpConnector<R>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<R> Connect for HttpConnector<R>

where R: Resolve + Clone + Send + Sync, <R as Resolve>::Future: Send,

type Transport = TcpStream

The connected IO Stream.

type Error = Error

An error occured when trying to connect.

type Future = HttpConnecting<R>

A Future that will resolve to the connected Transport.

fn connect(&self, dst: Destination) -> <HttpConnector<R> as Connect>::Future

Connect to a destination.

impl<R> Debug for HttpConnector<R>

where R: Debug,

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

Formats the value using the given formatter.