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 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.