Module aws_smithy_client::hyper_ext

source ·
Expand description

Implementation of SmithyConnector for Hyper

The module provides Adapter which enables using a hyper::Client as the connector for a Smithy Client. For most use cases, this shouldn’t need to be used directly, but it is available as an option.

Examples

Construct a Smithy Client with Hyper and Rustls

In the basic case, customers should not need to use this module. A default implementation of Hyper with rustls will be constructed during client creation. However, if you are creating a Smithy Client, directly, use the dyn_https_https() method to match that default behavior:

use aws_smithy_client::Client;

let client = Client::builder()
    .dyn_https_connector(Default::default())
    .middleware(
        // Replace this with your middleware type
        tower::layer::util::Identity::default()
    )
    .build();

Use a Hyper client that uses WebPKI roots

A use case for where you may want to use the Adapter is when settings Hyper client settings that aren’t otherwise exposed by the Client builder interface.

ⓘ
use std::time::Duration;
use aws_smithy_client::{Client, conns, hyper_ext};
use aws_smithy_client::erase::DynConnector;
use aws_smithy_client::http_connector::ConnectorSettings;

let https_connector = hyper_rustls::HttpsConnectorBuilder::new()
    .with_webpki_roots()
    .https_only()
    .enable_http1()
    .enable_http2()
    .build();
let smithy_connector = hyper_ext::Adapter::builder()
    // Optionally set things like timeouts as well
    .connector_settings(
        ConnectorSettings::builder()
            .connect_timeout(Duration::from_secs(5))
            .build()
    )
    .build(https_connector);

// Once you have a Smithy connector, use it to construct a Smithy client:
let client = Client::builder()
    .connector(smithy_connector)
    .middleware(tower::layer::util::Identity::default())
    .build();

Structs