Struct Client 

pub struct Client { /* private fields */ }

Available on crate feature default-client only.

Smithy HTTP client bound to one connection-pool partition.

Construction resolves the partition once. Every request uses that partition for establishment placement and local reuse, while the configured reuse scope may permit dispatch through a peer partition’s connection. Cloning a client shares the pool, resolved partition state, and reusable connections.

Implementations

impl Client

pub fn new(pool: &ConnectionPool) -> Result<Self, ClientBuildError>

Creates a client for a pool built without explicit partitions.

Errors

Returns ClientBuildError when the pool contains only explicit partitions.

Examples found in repository

examples/custom-dns.rs (line 34)

fn main() {
    let _legacy_client = Builder::new()
        .tls_provider(tls::Provider::Rustls(CryptoMode::Ring))
        .build_with_resolver(StaticResolver);

    let pool = ConnectionPool::builder()
        .dns_resolver(StaticResolver)
        .tls_provider(tls::Provider::Rustls(CryptoMode::Ring))
        .build_https()
        .expect("valid connection pool");
    let _partitioned_client =
        PoolClient::new(&pool).expect("pool contains the anonymous partition");
}

pub fn from_partition( pool: &ConnectionPool, id: PartitionId, ) -> Result<Self, ClientBuildError>

Creates a client bound to id.

The identity may name a declared partition or the anonymous partition retained by a pool built without declarations.

Errors

Returns ClientBuildError when the pool does not contain id.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Client

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

Formats the value using the given formatter.

impl HttpClient for Client

fn validate_base_client_config( &self, _: &RuntimeComponentsBuilder, _: &ConfigBag, ) -> Result<(), BoxError>

Validate the base client configuration.

fn http_connector( &self, settings: &HttpConnectorSettings, components: &RuntimeComponents, ) -> SharedHttpConnector

Returns a HTTP connector based on the requested connector settings.

fn connector_metadata(&self) -> Option<ConnectorMetadata>

Provide metadata about the crate that this HttpClient uses to make connectors.

fn validate_final_config( &self, runtime_components: &RuntimeComponents, cfg: &ConfigBag, ) -> Result<(), Box<dyn Error + Sync + Send>>

Validate the final client configuration.