Struct Client 

pub struct Client<Connector = (), Tls = ClientTlsPolicy, Authentication = TrustClientAuthentication, Middleware = IdentityHandler> { /* private fields */ }

Reusable client-role component.

Implementations

impl Client<()>

pub fn builder() -> ClientBuilder

Starts client-role configuration.

impl<Connector, Tls, Authentication, Middleware, Work, Transport, Error> Client<Connector, Tls, Authentication, Middleware>

where Connector: Fn(&ConnectTarget) -> Work, Work: Future<Output = Result<Transport, Error>>, Transport: AsyncRead + AsyncWrite + Unpin, Authentication: ClientAuthentication, Tls: ClientTlsConfiguration, Middleware: MiddlewareFactory<ClientInitialContext>,

pub async fn connect<State>( &self, target: ConnectTarget, overrides: StartupParameters, state: State, ) -> Result<ClientConnection<ClientTransport<Transport>, State, ConnectionClean, Authentication::Evidence, <Middleware as MiddlewareFactory<ClientInitialContext>>::Handler>, ConnectError<Error, ClientTlsError<<Tls::Provider as ClientTlsProvider>::Error>, ClientAuthenticationError<Authentication::Error>>>

where <Middleware as MiddlewareFactory<ClientInitialContext>>::Handler: ClientMiddleware<State, ClientConnectionContext<Authentication::Evidence>>,

Establishes transport, startup, and configured authentication before returning.

Per-call startup values explicitly override component defaults.

Errors

Returns a connection-time error for connector, startup, framing, authentication, or readiness failures.

impl<Connector, Tls, Authentication, Middleware, Work, Transport, Error> Client<Connector, Tls, Authentication, Middleware>

where Connector: Fn(&ConnectTarget) -> Work, Work: Future<Output = Result<Transport, Error>>, Transport: AsyncWrite + Unpin,

pub async fn cancel( &self, target: &ConnectTarget, key: &CancelKey, ) -> Result<(), CancelError<Error>>

Opens a fresh transport and writes exactly one raw cancellation packet.

Cancellation deliberately performs neither TLS negotiation nor startup authentication, as required by PostgreSQL’s out-of-band protocol.

Errors

Returns the connector’s typed error or a cancellation encode/write error.

Trait Implementations

impl<Connector: Clone, Tls: Clone, Authentication: Clone, Middleware: Clone> Clone for Client<Connector, Tls, Authentication, Middleware>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Connector, Tls: Debug, Authentication: Debug, Middleware> Debug for Client<Connector, Tls, Authentication, Middleware>

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

Formats the value using the given formatter.