La AWS SDK for Java version 1.x est entrée en mode maintenance le 31 juillet 2024 et atteindra end-of-support
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Configuration de client
AWS SDK for Java Cela vous permet de modifier la configuration par défaut du client, ce qui est utile lorsque vous souhaitez :
-
Se connecter à Internet via un proxy
-
Modifier les paramètres HTTP de transport, tels que le délai d'expiration de la connexion et les nouvelles tentatives de demande
-
Spécifier les TCP indications sur la taille de la mémoire tampon
Configuration de proxy
Lorsque vous créez un objet client, vous pouvez transmettre un ClientConfigurationobjet facultatif pour personnaliser la configuration du client.
Si vous vous connectez à Internet via un serveur proxy, vous devez configurer les paramètres du serveur proxy (hôte proxy, port et nom d'utilisateur/mot de passe) via l'objet ClientConfiguration.
HTTPConfiguration du transport
Vous pouvez configurer plusieurs options de HTTP transport à l'aide de l'ClientConfigurationobjet. De nouvelles options sont parfois ajoutées ; pour voir la liste complète des options que vous pouvez récupérer ou définir, consultez la AWS SDK for Java API référence.
Note
Chacune des valeurs configurables possède une valeur par défaut définie par une constante. Pour une liste des valeurs constantes pourClientConfiguration, voir Valeurs de champ constantes dans la AWS SDK for Java API référence.
Connexions maximales
Vous pouvez définir le nombre maximum autorisé de HTTP connexions ouvertes à l'aide du ClientConfiguration. setMaxConnectionsméthode.
Important
Définissez le nombre maximal de connexions de telle sorte qu'il corresponde au nombre de transactions simultanées. Vous éviterez ainsi des contentions de connexions et une dégradation des performances. Pour la valeur maximale de connexions par défaut, voir Valeurs de champ constantes dans la AWS SDK for Java API référence.
Délais et gestion des erreurs
Vous pouvez définir des options relatives aux délais d'expiration et à la gestion des erreurs liées aux HTTP connexions.
-
Délai de connexion
Le délai d'expiration de la connexion est le temps (en millisecondes) pendant lequel la HTTP connexion attendra pour établir une connexion avant d'abandonner. La valeur par défaut est 10 000 ms.
Pour définir vous-même cette valeur, utilisez le ClientConfiguration. setConnectionTimeoutméthode.
-
Durée de connexion jusqu'à la mise en ligne (TTL)
Par défaut, ils SDK essaieront de réutiliser HTTP les connexions aussi longtemps que possible. En cas de panne lorsqu'une connexion est établie avec un serveur mis hors service, le fait de disposer d'une limite TTL peut faciliter la restauration de l'application. Par exemple, définir une durée de 15 minutes TTL garantit que même si vous avez établi une connexion avec un serveur qui rencontre des problèmes, vous rétablirez une connexion avec un nouveau serveur dans les 15 minutes.
Pour définir la HTTP connexionTTL, utilisez le ClientConfiguration. setConnectionTTLméthode.
-
Nombre maximal de tentatives en cas d'erreur
Par défaut, le nombre maximal de tentatives en cas d'erreur est de 3. Vous pouvez définir une valeur différente en utilisant le ClientConfiguration. setMaxErrorRéessayer la méthode.
Adresse locale
Pour définir l'adresse locale à laquelle le HTTP client doit se lier, utilisez ClientConfiguration. setLocalAddress.
TCPConseils relatifs à la taille de la mémoire tampon
Les utilisateurs expérimentés qui souhaitent ajuster les TCP paramètres de bas niveau peuvent également définir des indications sur la taille de la TCP mémoire tampon dans l'ClientConfigurationobjet. La majorité des utilisateurs n'aura jamais besoin de modifier ces valeurs, mais elles sont fournies pour les utilisateurs avancés.
Les tailles de TCP mémoire tampon optimales pour une application dépendent fortement de la configuration et des capacités du réseau et du système d'exploitation. Par exemple, la plupart des systèmes d'exploitation modernes proposent une logique de réglage automatique de la taille de la TCP mémoire tampon. Cela peut avoir un impact important sur les performances des TCP connexions maintenues ouvertes suffisamment longtemps pour que le réglage automatique optimise la taille de la mémoire tampon.
Les tailles de mémoire tampon élevées (par exemple, 2 Mo) permettent au système d'exploitation de placer en mémoire tampon plus de données sans avoir besoin que le serveur distant accuse réception des informations et peuvent ainsi se révéler particulièrement utiles quand le réseau présente une latence élevée.
Il s'agit uniquement d'un conseil ; il se peut que le système d'exploitation ne le suive pas. Lors de l'utilisation de cette option, les utilisateurs doivent toujours vérifier les valeurs par défaut et les limites configurées du système d'exploitation. La plupart des systèmes d'exploitation ont configuré une limite de taille de TCP mémoire tampon maximale, et vous ne pouvez pas dépasser cette limite à moins que vous n'augmentiez explicitement la limite de taille maximale de la TCP mémoire tampon.
De nombreuses ressources sont disponibles pour vous aider à configurer la taille de la TCP mémoire tampon et les TCP paramètres spécifiques au système d'exploitation, notamment les suivantes :
