Struct TcpConnector
pub struct TcpConnector<Dns = GlobalDnsResolver, ConnectorFactory = ()> { /* private fields */ }
Expand description
A connector which can be used to establish a TCP connection to a server.
Implementations§
§impl TcpConnector
impl TcpConnector
pub fn new() -> TcpConnector
pub fn new() -> TcpConnector
Create a new TcpConnector
, which is used to establish a connection to a server.
You can use middleware around the TcpConnector
or add connection pools, retry logic and more.
§impl<Dns, ConnectorFactory> TcpConnector<Dns, ConnectorFactory>
impl<Dns, ConnectorFactory> TcpConnector<Dns, ConnectorFactory>
pub fn with_dns<OtherDns>(
self,
dns: OtherDns,
) -> TcpConnector<OtherDns, ConnectorFactory>where
OtherDns: DnsResolver + Clone,
pub fn with_dns<OtherDns>(
self,
dns: OtherDns,
) -> TcpConnector<OtherDns, ConnectorFactory>where
OtherDns: DnsResolver + Clone,
Consume self
to attach the given dns
(a DnsResolver
) as a new TcpConnector
.
§impl<Dns> TcpConnector<Dns>
impl<Dns> TcpConnector<Dns>
pub fn with_connector<Connector>(
self,
connector: Connector,
) -> TcpConnector<Dns, TcpStreamConnectorCloneFactory<Connector>>
pub fn with_connector<Connector>( self, connector: Connector, ) -> TcpConnector<Dns, TcpStreamConnectorCloneFactory<Connector>>
Consume self
to attach the given Connector
(a TcpStreamConnector
) as a new TcpConnector
.
pub fn with_connector_factory<Factory>(
self,
factory: Factory,
) -> TcpConnector<Dns, Factory>
pub fn with_connector_factory<Factory>( self, factory: Factory, ) -> TcpConnector<Dns, Factory>
Consume self
to attach the given Factory
(a TcpStreamConnectorFactory
) as a new TcpConnector
.
Trait Implementations§
§impl<Dns, ConnectorFactory> Clone for TcpConnector<Dns, ConnectorFactory>
impl<Dns, ConnectorFactory> Clone for TcpConnector<Dns, ConnectorFactory>
§fn clone(&self) -> TcpConnector<Dns, ConnectorFactory>
fn clone(&self) -> TcpConnector<Dns, ConnectorFactory>
Returns a duplicate of the value. Read more
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from
source
. Read more§impl<Dns, ConnectorFactory> Debug for TcpConnector<Dns, ConnectorFactory>
impl<Dns, ConnectorFactory> Debug for TcpConnector<Dns, ConnectorFactory>
§impl Default for TcpConnector
impl Default for TcpConnector
§fn default() -> TcpConnector
fn default() -> TcpConnector
Returns the “default value” for a type. Read more
§impl<Request, Dns, ConnectorFactory> Service<Request> for TcpConnector<Dns, ConnectorFactory>where
Request: TryRefIntoTransportContext + Send + 'static,
<Request as TryRefIntoTransportContext>::Error: Into<Box<dyn Error + Sync + Send>> + Send + Sync + 'static,
Dns: DnsResolver + Clone,
ConnectorFactory: TcpStreamConnectorFactory + Clone,
<ConnectorFactory as TcpStreamConnectorFactory>::Connector: TcpStreamConnector,
<<ConnectorFactory as TcpStreamConnectorFactory>::Connector as TcpStreamConnector>::Error: Into<Box<dyn Error + Sync + Send>> + Send + 'static,
<ConnectorFactory as TcpStreamConnectorFactory>::Error: Into<Box<dyn Error + Sync + Send>> + Send + 'static,
impl<Request, Dns, ConnectorFactory> Service<Request> for TcpConnector<Dns, ConnectorFactory>where
Request: TryRefIntoTransportContext + Send + 'static,
<Request as TryRefIntoTransportContext>::Error: Into<Box<dyn Error + Sync + Send>> + Send + Sync + 'static,
Dns: DnsResolver + Clone,
ConnectorFactory: TcpStreamConnectorFactory + Clone,
<ConnectorFactory as TcpStreamConnectorFactory>::Connector: TcpStreamConnector,
<<ConnectorFactory as TcpStreamConnectorFactory>::Connector as TcpStreamConnector>::Error: Into<Box<dyn Error + Sync + Send>> + Send + 'static,
<ConnectorFactory as TcpStreamConnectorFactory>::Error: Into<Box<dyn Error + Sync + Send>> + Send + 'static,
§type Response = EstablishedClientConnection<TcpStream, Request>
type Response = EstablishedClientConnection<TcpStream, Request>
The type of response returned by the service.
§async fn serve(
&self,
ctx: Context,
req: Request,
) -> Result<<TcpConnector<Dns, ConnectorFactory> as Service<Request>>::Response, <TcpConnector<Dns, ConnectorFactory> as Service<Request>>::Error>
async fn serve( &self, ctx: Context, req: Request, ) -> Result<<TcpConnector<Dns, ConnectorFactory> as Service<Request>>::Response, <TcpConnector<Dns, ConnectorFactory> as Service<Request>>::Error>
Serve a response or error for the given request,
using the given context.
§fn boxed(self) -> BoxService<Request, Self::Response, Self::Error>
fn boxed(self) -> BoxService<Request, Self::Response, Self::Error>
Box this service to allow for dynamic dispatch.
Auto Trait Implementations§
impl<Dns, ConnectorFactory> Freeze for TcpConnector<Dns, ConnectorFactory>
impl<Dns, ConnectorFactory> RefUnwindSafe for TcpConnector<Dns, ConnectorFactory>where
Dns: RefUnwindSafe,
ConnectorFactory: RefUnwindSafe,
impl<Dns, ConnectorFactory> Send for TcpConnector<Dns, ConnectorFactory>
impl<Dns, ConnectorFactory> Sync for TcpConnector<Dns, ConnectorFactory>
impl<Dns, ConnectorFactory> Unpin for TcpConnector<Dns, ConnectorFactory>
impl<Dns, ConnectorFactory> UnwindSafe for TcpConnector<Dns, ConnectorFactory>where
Dns: UnwindSafe,
ConnectorFactory: UnwindSafe,
Blanket Implementations§
§impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
§impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<S, Request, Connection> ConnectorService<Request> for S
impl<S, Request, Connection> ConnectorService<Request> for S
§type Connection = Connection
type Connection = Connection
Connection returned by the
ConnectorService
§fn connect(
&self,
ctx: Context,
req: Request,
) -> impl Future<Output = Result<EstablishedClientConnection<<S as ConnectorService<Request>>::Connection, Request>, <S as ConnectorService<Request>>::Error>> + Send
fn connect( &self, ctx: Context, req: Request, ) -> impl Future<Output = Result<EstablishedClientConnection<<S as ConnectorService<Request>>::Connection, Request>, <S as ConnectorService<Request>>::Error>> + Send
Establish a connection, which often involves some kind of handshake,
or connection revival.
§impl<T> FutureExt for T
impl<T> FutureExt for T
§fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ
fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ
§fn with_current_context(self) -> WithContext<Self> ⓘ
fn with_current_context(self) -> WithContext<Self> ⓘ
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
Converts
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
Converts
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more§impl<T> Pointable for T
impl<T> Pointable for T
§impl<T> PolicyExt for Twhere
T: ?Sized,
impl<T> PolicyExt for Twhere
T: ?Sized,
§fn and<P, B, E>(self, other: P) -> And<T, P>
fn and<P, B, E>(self, other: P) -> And<T, P>
Create a new
Policy
that returns Action::Follow
only if self
and other
return
Action::Follow
. Read more