Configurazione del client - AWS SDK for Java 1.x

Abbiamo annunciato l'imminente versione end-of-support di AWS SDK for Java (v1). Ti consigliamo di migrare alla AWS SDK for Java v2. Per date, dettagli aggiuntivi e informazioni su come effettuare la migrazione, consulta l'annuncio collegato.

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 di trasporto HTTP, ad esempio il timeout della connessione e i tentativi di richiesta

  • Specificare i suggerimenti sulla dimensione del buffer del socket TCP

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

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 è possibile recuperare o impostare, consulta l' 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, consulta Constant Field Values nel riferimento AWS SDK for Java API.

Numero massimo connessioni

È possibile impostare il numero massimo consentito di connessioni HTTP 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, consulta Constant Field Values nel riferimento AWS SDK for Java API.

Timeout e gestione degli errori

È possibile impostare opzioni relative ai timeout e alla gestione degli errori con le connessioni HTTP.

Indirizzo locale

Per impostare l'indirizzo locale a cui il client HTTP si collegherà, usaClientConfiguration. setLocalAddress.

Suggerimenti sulla dimensione del buffer del socket TCP

Gli utenti esperti che desiderano ottimizzare 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 regolazione automatica per le dimensioni del buffer TCP. Ciò può avere un grande impatto sulle prestazioni delle connessioni TCP che vengono mantenute aperte abbastanza a lungo da consentire l'ottimizzazione automatica per ottimizzare le dimensioni del buffer.

Le grandi dimensioni del buffer (ad esempio, 2 MB) consentono al sistema operativo di bufferizzare 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 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 massimo di dimensione del buffer TCP configurato e non consente di superare tale limite a meno che non aumenti esplicitamente il limite massimo di dimensione del buffer TCP.

Sono disponibili molte risorse per facilitare la configurazione delle dimensioni del buffer TCP e delle impostazioni TCP specifiche del sistema operativo, tra cui: