Configurazione del client - AWS SDK for Java 2.x
Client HTTPProxy client HTTPSostituzioni del client Il client annulla i tentativiClient asincroni Altre modifiche al cliente

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configurazione del client

Nella versione 1.x, la configurazione del client SDK è stata modificata impostando un'ClientConfigurationistanza sul client o sul client builder. Nella versione 2.x, la configurazione del client è suddivisa in classi di configurazione separate. Con le classi di configurazione separate, puoi configurare diversi client HTTP per client asincroni e sincroni, ma utilizzare comunque la stessa classe. ClientOverrideConfiguration

Esempio della configurazione del client nella versione 1.x
AmazonDynamoDBClientBuilder.standard()
.withClientConfiguration(clientConfiguration)
.build()
Esempio di configurazione del client sincrono nella versione 2.x
ProxyConfiguration.Builder proxyConfig = ProxyConfiguration.builder();

ApacheHttpClient.Builder httpClientBuilder =
        ApacheHttpClient.builder()
                        .proxyConfiguration(proxyConfig.build());

ClientOverrideConfiguration.Builder overrideConfig =
        ClientOverrideConfiguration.builder();

DynamoDbClient client =
        DynamoDbClient.builder()
                      .httpClientBuilder(httpClientBuilder)
                      .overrideConfiguration(overrideConfig.build())
                      .build();
Esempio di configurazione del client asincrono nella versione 2.x
NettyNioAsyncHttpClient.Builder httpClientBuilder =
        NettyNioAsyncHttpClient.builder();

ClientOverrideConfiguration.Builder overrideConfig =
        ClientOverrideConfiguration.builder();

ClientAsyncConfiguration.Builder asyncConfig =
        ClientAsyncConfiguration.builder();

DynamoDbAsyncClient client =
        DynamoDbAsyncClient.builder()
                           .httpClientBuilder(httpClientBuilder)
                           .overrideConfiguration(overrideConfig.build())
                           .asyncConfiguration(asyncConfig.build())
                           .build();

Client HTTP

Modifiche importanti

  • Nella versione 2.x, è possibile modificare il client HTTP da utilizzare in fase di esecuzione specificando un'implementazione utilizzando. clientBuilder.httpClientBuilder

  • Quando si passa un client HTTP utilizzando clientBuilder.httpClient a un service client builder, il client HTTP non viene chiuso per impostazione predefinita se il client di servizio si chiude. Ciò consente di condividere client HTTP tra client di servizio.

  • I client HTTP asincroni ora utilizzano un IO non bloccante.

  • Alcune operazioni ora utilizzano HTTP/2 per migliorare le prestazioni.

Modifiche alle impostazioni

Impostazione 1.x Sincronizzazione 2.x, Apache 2.x Asincrono, Netty 
ClientConfiguration clientConfig = 
    new ClientConfiguration()
 
ApacheHttpClient.Builder httpClientBuilder = 
    ApacheHttpClient.builder()
 
NettyNioAsyncHttpClient.Builder httpClientBuilder = 
    NettyNioAsyncHttpClient.builder()
Numero massimo di connessioni 
clientConfig.setMaxConnections(...)
clientConfig.withMaxConnections(...)
 
httpClientBuilder.maxConnections(...)
 
httpClientBuilder.maxConcurrency(...)
Timeout di connessione 
clientConfig.setConnectionTimeout(...)
clientConfig.withConnectionTimeout(...)
 
httpClientBuilder.connectionTimeout(...)
httpClientBuilder.connectionAcquisitionTimeout(...)
 
httpClientBuilder.connectionTimeout(...)
Timeout del socket 
clientConfig.setSocketTimeout(...)
clientConfig.withSocketTimeout(...)
 
httpClientBuilder.socketTimeout(...)
 
httpClientBuilder.writeTimeout(...)
httpClientBuilder.readTimeout(...)
Connessione TTL 
clientConfig.setConnectionTTL(...)
clientConfig.withConnectionTTL(...)
 
httpClientBuilder.connectionTimeToLive(...)
 
httpClientBuilder.connectionTimeToLive(...)
Connessione massima inattiva 
clientConfig.setConnectionMaxIdleMillis(...)
clientConfig.withConnectionMaxIdleMillis(...)
 
httpClientBuilder.connectionMaxIdleTime(...)
 
httpClientBuilder.connectionMaxIdleTime(...)
Convalida dopo l'inattività 
clientConfig.setValidateAfterInactivityMillis(...)
clientConfig.withValidateAfterInactivityMillis(...)
 Non supportato (funzionalità di richiesta) Non supportato (funzionalità di richiesta)
Indirizzo locale 
clientConfig.setLocalAddress(...)
clientConfig.withLocalAddress(...)
 
httpClientBuilder.localAddress(...)
 Non supportato
Expect-continue abilitato 
clientConfig.setUseExpectContinue(...)
clientConfig.withUseExpectContinue(...)
 
httpClientBuilder.expectContinueEnabled(...)
 Non supportato (funzionalità di richiesta)
Connection Reaper 
clientConfig.setUseReaper(...)
clientConfig.withReaper(...)
 
httpClientBuilder.useIdleConnectionReaper(...)
 
httpClientBuilder.useIdleConnectionReaper(...)
 
AmazonDynamoDBClientBuilder.standard()
    .withClientConfiguration(clientConfiguration)
    .build()
 
DynamoDbClient.builder()
    .httpClientBuilder(httpClientBuilder)
    .build()
 
DynamoDbAsyncClient.builder()
.httpClientBuilder(httpClientBuilder)
.build()

Proxy client HTTP

Impostazioni 1.x Sincronizzazione 2.x, Apache 2.x Asincrono, Netty 
ClientConfiguration clientConfig =
    new ClientConfiguration()
 
ProxyConfiguration.Builder proxyConfig =
    ProxyConfiguration.builder()
 
ProxyConfiguration.Builder proxyConfig =
    ProxyConfiguration.builder()
Host proxy 
clientConfig.setProxyHost(...)
clientConfig.withProxyHost(...)
 
proxyConfig.endpoint(...)
 
proxyConfig.host(...)
Porta proxy 
clientConfig.setProxyPort(...)
clientConfig.withProxyPort(...)
 
proxyConfig.endpoint(...)

La porta proxy è incorporata in endpoint

 
proxyConfig.port(...)
Nome utente proxy 
clientConfig.setProxyUsername(...)
clientConfig.withProxyUsername(...)
 
proxyConfig.username(...)
 
proxyConfig.username(...)
Password proxy 
clientConfig.setProxyPassword(...)
clientConfig.withProxyPassword(...)
 
proxyConfig.password(...)
 
proxyConfig.password(...)
Dominio proxy 
clientConfig.setProxyDomain(...)
clientConfig.withProxyDomain(...)
 
proxyConfig.ntlmDomain(...)
 Non supportato (funzionalità di richiesta)
Workstation proxy 
clientConfig.setProxyWorkspace(...)
clientConfig.withProxyWorkstation(...)
 
proxyConfig.ntlmWorkstation(...)
 Non supportata (funzionalità di richiesta)
Metodi di autenticazione proxy 
clientConfig.setProxyAuthenticationMethods(...)
clientConfig.withProxyAuthenticationMethods(...)

Non supportato

 Non supportato (funzionalità di richiesta)
Autenticazione proxy di base preventiva 
clientConfig.setPreemptiveBasicProxyAuth(...)
clientConfig.withPreemptiveBasicProxyAuth(...)
 
proxyConfig.preemptiveBasicAuthenticationEnabled(...)
 Non supportata (funzionalità di richiesta)
Host non proxy 
clientConfig.setNonProxyHosts(...)
clientConfig.withNonProxyHosts(...)
 
proxyConfig.nonProxyHosts(...)
 
proxyConfig.nonProxyHosts(...)
Disabilita il socket proxy 
clientConfig.setDisableSocketProxy(...)
clientConfig.withDisableSocketProxy(...)
 Non supportato (funzionalità di richiesta) Non supportato (funzionalità di richiesta) 
AmazonDynamoDBClientBuilder.standard()
    .withClientConfiguration(clientConfiguration)
    .build()
 
httpClientBuilder.proxyConfiguration(
    proxyConfig.build())
 
httpClientBuilder.proxyConfiguration(
    proxyConfig.build())

Sostituzioni del client

Impostazione 1.x 2.x 
ClientConfiguration clientConfig =
    new ClientConfiguration()
 
ClientOverrideConfiguration.Builder overrideConfig =
    ClientOverrideConfiguration.builder()
Prefisso dell'agente utente 
clientConfig.setUserAgentPrefix(...)
clientConfig.withUserAgentPrefix(...)
 
overrideConfig.advancedOption(
    SdkAdvancedClientOption.USER_AGENT_PREFIX, ...)
Suffisso dell'agente utente 
clientConfig.setUserAgentSuffix(...)
clientConfig.withUserAgentSuffix(...)
 
overrideConfig.advancedOption(
    SdkAdvancedClientOption.USER_AGENT_SUFFIX, ...)
Signer 
clientConfig.setSignerOverride(...)
clientConfig.withSignerOverride(...)
 
overrideConfig.advancedOption(
    SdkAdvancedClientOption.SIGNER, ...)
Intestazioni aggiuntive 
clientConfig.addHeader(...)
clientConfig.withHeader(...)
 
overrideConfig.putHeader(...)
Timeout richiesta 
clientConfig.setRequestTimeout(...)
clientConfig.withRequestTimeout(...)
 
overrideConfig.apiCallAttemptTimeout(...)
Timeout di esecuzione del client 
clientConfig.setClientExecutionTimeout(...)
clientConfig.withClientExecutionTimeout(...)
 
overrideConfig.apiCallTimeout(...)
Usa Gzip 
clientConfig.setUseGzip(...)
clientConfig.withGzip(...)

Non supportato (funzionalità di richiesta)
Suggerimento sulla dimensione del buffer del socket 
clientConfig.setSocketBufferSizeHints(...)
clientConfig.withSocketBufferSizeHints(...)
 Non supportato (funzionalità di richiesta)
Metadati di risposta alla cache 
clientConfig.setCacheResponseMetadata(...)
clientConfig.withCacheResponseMetadata(...)
 Non supportato (funzionalità di richiesta)
Dimensione della cache dei metadati di risposta 
clientConfig.setResponseMetadataCacheSize(...)
clientConfig.withResponseMetadataCacheSize(...)
 Non supportata (funzionalità di richiesta)
resolver DNS 
clientConfig.setDnsResolver(...)
clientConfig.withDnsResolver(...)
 Non supportato (funzionalità di richiesta)
TCP keepalive 
clientConfig.setUseTcpKeepAlive(...)
clientConfig.withTcpKeepAlive(...)

Questa opzione è ora nella configurazione del client HTTP

- ApacheHttpClient.builder().tcpKeepAlive(true)
- NettyNioAsyncHttpClient.builder().tcpKeepAlive(true)
Secure Random 
clientConfig.setSecureRandom(...)
clientConfig.withSecureRandom(...)
 Non supportato (funzionalità di richiesta) 
AmazonDynamoDBClientBuilder.standard()
    .withClientConfiguration(clientConfiguration)
    .build()
 
DynamoDbClient.builder()
    .overrideConfiguration(overrideConfig.build())
    .build()

Il client annulla i tentativi

Impostazione 1.x 2.x 
ClientConfiguration clientConfig =
    new ClientConfiguration()
 
ClientOverrideConfiguration.Builder overrideConfigBuilder = 
    ClientOverrideConfiguration.builder();
Numero massimo di tentativi di errore 
clientConfig.setMaxErrorRetry(...)
clientConfig.withMaxErrorRetry(...)
 
// Configure the default retry strategy.
overrideConfigBuilder.retryStrategy(b -> b.maxAttempts(...));
Usa tentativi limitati 
clientConfig.setUseThrottleRetries(...)
clientConfig.withUseThrottleRetries(...)
 Non supportato
Numero massimo di tentativi consecutivi prima della limitazione 
clientConfig.setMaxConsecutiveRetriesBeforeThrottling(...)
clientConfig.withMaxConsecutiveRetriesBeforeThrottling(...)
 Non supportato 
AmazonDynamoDBClientBuilder.standard()
    .withClientConfiguration(clientConfiguration)
    .build()
 
DynamoDbClient.builder()
        .overrideConfiguration(overrideConfigBuilder.build())
        .build();

// You also have the option to use a lambda expression to configure and
// build the 'ClientOverrideConfiguration.Builder'.
DynamoDbClient client = DynamoDbClient.builder()
        .overrideConfiguration(o -> o.retryStrategy(b -> b.maxAttempts(5)))
        .build();

Client asincroni

Impostazione 1.x 2.x 
ClientAsyncConfiguration.Builder asyncConfig =
    ClientAsyncConfiguration.builder()
Esecutore 
AmazonDynamoDBAsyncClientBuilder.standard()
    .withExecutorFactory(...)
    .build()
 
asyncConfig.advancedOption(
    SdkAdvancedAsyncClientOption.FUTURE_COMPLETION_EXECUTOR, ...)
 
DynamoDbAsyncClient.builder()
    .asyncConfiguration(asyncConfig)
    .build()

Altre modifiche al cliente

La seguente ClientConfiguration opzione di 1.x è stata modificata nella versione 2.x dell'SDK e non ha un equivalente diretto.

Impostazione 1.x Equivalente a 2.x
Protocollo 
clientConfig.setProtocol(Protocol.HTTP)
clientConfig.withProtocol(Protocol.HTTP)

L'impostazione predefinita del protocollo è HTTPS. Per modificare l'impostazione, specifica il protocollo che imposta un endpoint HTTP nel client builder:

clientBuilder.endpointOverride(
    URI.create("http://..."))