La AWS SDK for Java versione 1.x è entrata in modalità manutenzione il 31 luglio 2024 e sarà disponibile il 31 end-of-support
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
AWS SDK for Java Consente di modificare la configurazione predefinita del client, utile quando si desidera:
-
Connect a Internet tramite proxy
-
Modifica le impostazioni HTTP di trasporto, ad esempio il timeout della connessione e i nuovi tentativi di richiesta
-
Specificate i suggerimenti sulla dimensione del buffer del TCP socket
Configurazione proxy
Quando si costruisce un oggetto client, è possibile passare un ClientConfigurationoggetto opzionale per personalizzare la configurazione del client.
Se ti connetti a Internet tramite un server proxy, dovrai configurare le impostazioni del server proxy (host proxy, porta e nome utente/password) tramite l'oggetto. ClientConfiguration
HTTPConfigurazione del trasporto
È possibile configurare diverse opzioni di HTTP trasporto utilizzando l'ClientConfigurationoggetto. Di tanto in tanto vengono aggiunte nuove opzioni; per vedere l'elenco completo delle opzioni che è possibile recuperare o impostare, consulta il AWS SDK for Java API Reference.
Nota
Ciascuno dei valori configurabili ha un valore predefinito definito da una costante. Per un elenco dei valori costanti perClientConfiguration, vedere Valori dei campi costanti nel AWS SDK for Java API riferimento.
Numero massimo connessioni
È possibile impostare il numero massimo consentito di HTTP connessioni aperte utilizzando ClientConfiguration. setMaxConnectionsmetodo.
Importante
Imposta il numero massimo di connessioni per il numero di transazioni simultanee per evitare problemi e performance scarse. Per il valore massimo di connessioni predefinito, vedere Valori di campo costanti nel AWS SDK for Java API riferimento.
Timeout e gestione degli errori
È possibile impostare opzioni relative ai timeout e alla gestione degli errori nelle connessioni. HTTP
-
Timeout di connessione
Il timeout della connessione è la quantità di tempo (in millisecondi) che la HTTP connessione aspetterà per stabilire una connessione prima di rinunciare. L'impostazione predefinita è 10.000 ms.
Per impostare tu stesso questo valore, usa il ClientConfiguration. setConnectionTimeoutmetodo.
-
Tempo di connessione a Live (TTL)
Per impostazione predefinita, SDK tenterà di riutilizzare HTTP le connessioni il più a lungo possibile. In situazioni di errore in cui viene stabilita una connessione a un server che è stato messo fuori servizio, disporre di una connessione limitata TTL può facilitare il ripristino dell'applicazione. Ad esempio, impostando una durata di 15 minutiTTL, anche se è stata stabilita una connessione a un server con problemi, sarà possibile ristabilire la connessione a un nuovo server entro 15 minuti.
Per impostare la HTTP connessioneTTL, utilizzare ilClientConfiguration. setConnectionTTLmetodo.
-
Numero massimo di tentativi di errore
Il numero massimo di tentativi predefinito per gli errori recuperabili è 3. È possibile impostare un valore diverso utilizzando il. ClientConfiguration setMaxErrorMetodo Retry.
Indirizzo locale
TCPSuggerimenti sulla dimensione del buffer del socket
Gli utenti esperti che desiderano ottimizzare i TCP parametri di basso livello possono inoltre impostare suggerimenti sulla dimensione del TCP buffer tramite l'oggetto. ClientConfiguration La maggior parte degli utenti non avrà mai bisogno di modificare questi valori, ma sono disponibili per utenti esperti.
Le dimensioni ottimali TCP del buffer per un'applicazione dipendono in larga misura dalla configurazione e dalle funzionalità della rete e del sistema operativo. Ad esempio, la maggior parte dei sistemi operativi moderni fornisce una logica di regolazione automatica per le dimensioni del TCP buffer. Ciò può avere un grande impatto sulle prestazioni delle TCP connessioni che vengono mantenute aperte abbastanza a lungo da consentire l'ottimizzazione automatica delle dimensioni del buffer.
Le grandi dimensioni del buffer (ad esempio, 2 MB) consentono al sistema operativo di bufferizzare una maggiore quantità di dati in memoria senza richiedere al server remoto di confermare la ricezione di tali informazioni, e quindi possono essere particolarmente utili quando la rete ha un'elevata latenza.
Questo è solo un suggerimento e il sistema operativo potrebbe non rispettarlo. Quando si utilizza questa opzione, gli utenti devono sempre verificare i limiti e le impostazioni predefinite configurati del sistema operativo. La maggior parte dei sistemi operativi ha un limite di dimensione massima del TCP buffer configurato e non consente di superare tale limite a meno che non aumenti esplicitamente il limite massimo TCP di dimensione del buffer.
Sono disponibili molte risorse per facilitare la configurazione delle dimensioni del TCP buffer e delle impostazioni specifiche del sistema operativo, tra TCP cui:
