La versione AWS SDK per Java 1.x ha raggiunto la fine del supporto il 31 dicembre 2025. Ti consigliamo di eseguire la migrazione alla versione per continuare AWS SDK for Java 2.x a ricevere nuove funzionalità, miglioramenti della disponibilità e aggiornamenti di sicurezza.
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 per Java Consente di modificare la configurazione predefinita del client, utile quando si desidera:
-
Connettersi a Internet tramite proxy
-
Modifica le impostazioni di trasporto HTTP, ad esempio il timeout della connessione e i tentativi di richiesta
-
Specifica i suggerimenti sulla dimensione del buffer del socket TCP
Configurazione proxy
Quando si costruisce un oggetto client, è possibile passare un ClientConfiguration oggetto 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 username/password) tramite l'ClientConfigurationoggetto.
Configurazione del trasporto HTTP
È possibile configurare diverse opzioni di trasporto HTTP utilizzando l'ClientConfigurationoggetto. Di tanto in tanto vengono aggiunte nuove opzioni; per visualizzare l'elenco completo delle opzioni che puoi recuperare o impostare, consulta l' AWS SDK per Java API Reference.
Nota
Ciascuno dei valori configurabili ha un valore predefinito definito da una costante. Per un elenco dei valori costanti perClientConfiguration, consulta Constant Field Values nel riferimento AWS SDK per Java API.
Numero massimo connessioni
È possibile impostare il numero massimo consentito di connessioni HTTP aperte utilizzando il metodo ClientConfiguration.setMaxConnections.
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, consulta Constant Field Values nel riferimento AWS SDK per Java API.
Timeout e gestione degli errori
È possibile impostare le opzioni relative ai timeout e alla gestione degli errori con le connessioni HTTP.
-
Timeout della connessione
Il timeout della connessione è la quantità di tempo (in millisecondi) che la connessione HTTP aspetterà per stabilire una connessione prima di interrompersi. L'impostazione predefinita è 10.000 ms.
Per impostare questo valore tu stesso, usa il ClientConfiguration.setConnectionTimeout metodo.
-
Connection Time to Live (TTL)
Per impostazione predefinita, l'SDK tenterà di riutilizzare le connessioni HTTP il più a lungo possibile. In situazioni di errore in cui viene stabilita una connessione a un server che è stato messo fuori servizio, avere un TTL limitato può aiutare il ripristino dell'applicazione. Ad esempio, impostando un TTL di 15 minuti, anche in caso di connessione stabilita a un server che presenta problemi, sarà possibile ristabilire una connessione a un nuovo server entro 15 minuti.
Per impostare il TTL della connessione HTTP, utilizzate il metodo. ClientConfiguration.setConnectionTTL
-
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.setMaxErrorRetry metodo.
Indirizzo locale
Per impostare l'indirizzo locale a cui verrà associato il client HTTP, usa ClientConfiguration.setLocalAddress.
Suggerimenti sulla dimensione del buffer del socket TCP
Gli utenti esperti che desiderano regolare i parametri TCP di basso livello possono inoltre impostare suggerimenti sulla dimensione del buffer TCP 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 del buffer TCP 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 ottimizzazione automatica per le dimensioni del buffer TCP. Ciò può avere un notevole impatto sulle prestazioni delle connessioni TCP 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 memorizzare più 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 una latenza elevata.
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 massimo di dimensione del buffer TCP configurato e non consente di superare tale limite a meno che non si aumenti esplicitamente il limite massimo di dimensione del buffer TCP.
Sono disponibili molte risorse per aiutare a configurare le dimensioni del buffer TCP e le impostazioni TCP specifiche del sistema operativo, tra cui:
