Struct Builder 

pub struct Builder<Tls = TlsUnset> { /* private fields */ }

Available on crate feature default-client only.

Builder for a hyper-backed HttpClient implementation.

This builder can be used to customize the underlying TCP connector used, as well as hyper client configuration.

Examples

Construct a Hyper client with the RusTLS TLS implementation. This can be useful when you want to share a Hyper connector between multiple generated Smithy clients.

Implementations

impl Builder<TlsProviderSelected>

pub fn build_https(self) -> SharedHttpClient

Available on crate features rustls-aws-lc or rustls-aws-lc-fips or rustls-ring or s2n-tls only.

Create an HTTPS client with the selected TLS provider.

The trusted certificates will be loaded later when this becomes the selected HTTP client for a Smithy client.

Examples found in repository

examples/client-ring.rs (line 14)

fn main() {
    let _client = Builder::new()
        .tls_provider(tls::Provider::Rustls(CryptoMode::Ring))
        .build_https();
}

pub fn build_with_resolver( self, resolver: impl ResolveDns + Clone + 'static, ) -> SharedHttpClient

Available on crate features rustls-aws-lc or rustls-aws-lc-fips or rustls-ring or s2n-tls only.

Create an HTTPS client using a custom DNS resolver

Examples found in repository

examples/custom-dns.rs (line 25)

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

pub fn tls_context(self, ctx: TlsContext) -> Self

Available on crate features rustls-aws-lc or rustls-aws-lc-fips or rustls-ring or s2n-tls only.

Configure the TLS context

impl<Any> Builder<Any>

pub fn pool_idle_timeout<D>(self, val: D) -> Self

where D: Into<Option<Duration>>,

Set an optional timeout for idle sockets being kept-alive.

Pass None to disable timeout.

Defaults to Hyper’s default timeout, which is currently 90 seconds - see hyper_util::client::legacy::Builder::pool_idle_timeout, but unlike that function, there is no need to call pool_timer yourself.

Examples

use aws_smithy_http_client::{Builder, tls};
use std::time::Duration;

let client = Builder::new()
    .pool_idle_timeout(Duration::from_secs(30))
    .tls_provider(tls::Provider::Rustls(tls::rustls_provider::CryptoMode::AwsLc))
    .build_https();

pub fn set_pool_idle_timeout( &mut self, val: Option<Option<Duration>>, ) -> &mut Self

Set an optional timeout for idle sockets being kept-alive.

Pass None to use Hyper’s default timeout, Some(None) to disable timeouts.

This is the mutable version of pool_idle_timeout.

Examples

use std::time::Duration;
use aws_smithy_http_client::{Builder, tls};

let mut client = Builder::new();
client.set_pool_idle_timeout(Some(Some(Duration::from_secs(30))));
client
    .tls_provider(tls::Provider::Rustls(tls::rustls_provider::CryptoMode::AwsLc))
    .build_https();

impl Builder<TlsUnset>

pub fn new() -> Self

Creates a new builder.

Examples found in repository

examples/client-ring.rs (line 12)

fn main() {
    let _client = Builder::new()
        .tls_provider(tls::Provider::Rustls(CryptoMode::Ring))
        .build_https();
}

examples/custom-dns.rs (line 23)

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

pub fn tls_provider(self, provider: Provider) -> Builder<TlsProviderSelected>

Set the TLS implementation to use

Examples found in repository

examples/client-ring.rs (line 13)

fn main() {
    let _client = Builder::new()
        .tls_provider(tls::Provider::Rustls(CryptoMode::Ring))
        .build_https();
}

examples/custom-dns.rs (line 24)

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

Trait Implementations

impl<Tls: Clone> Clone for Builder<Tls>

fn clone(&self) -> Builder<Tls>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Tls: Debug> Debug for Builder<Tls>

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

Formats the value using the given formatter.

impl<Tls: Default> Default for Builder<Tls>

fn default() -> Builder<Tls>

Returns the “default value” for a type.