View a markdown version of this page

Configurez les clients HTTP dans AWS SDK for Java 2.x - AWS SDK for Java 2.x
Clients disponiblesRecommandations des clientsDéfauts intelligents

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.

Configurez les clients HTTP dans AWS SDK for Java 2.x

Vous pouvez modifier le client HTTP à utiliser pour votre client de service et modifier la configuration par défaut pour les clients HTTP avec le AWS SDK for Java 2.x. Cette section décrit les clients HTTP et les paramètres du SDK.

Clients HTTP disponibles dans le SDK for Java

Clients synchrones

Les clients HTTP synchrones du SDK for Java SdkHttpClientimplémentent l'interface. Un client de service synchrone, tel que le S3Client ou leDynamoDbClient, nécessite l'utilisation d'un client HTTP synchrone. AWS SDK pour Java Il propose trois clients HTTP synchrones.

ApacheHttpClient (par défaut)

ApacheHttpClientest le client HTTP par défaut pour les clients de service synchrones. Pour plus d'informations sur la configuration duApacheHttpClient, consultezConfiguration du client HTTP basé sur Apache.

AwsCrtHttpClient

AwsCrtHttpClientfournit un débit élevé et des E/S non bloquantes. Il est basé sur le client HTTP AWS Common Runtime (CRT). Pour plus d'informations sur la configuration du AwsCrtHttpClient et son utilisation avec les clients de service, consultezConfiguration de clients AWS HTTP basés sur CRT.

UrlConnectionHttpClient

Pour minimiser le nombre de fichiers JAR et de bibliothèques tierces utilisés par votre application, vous pouvez utiliser le UrlConnectionHttpClient. Pour plus d'informations sur la configuration duUrlConnectionHttpClient, consultezConfiguration du client HTTP URLConnection basé.

Apache 5 HttpClient

Apache5 HttpClient est une version mise à jour ApacheHttpClient qui est basée sur Apache 5.x. HttpClient La version 5.x est la version activement maintenue par Apache. Elle améliore la version précédente utilisée en apportant la compatibilité avec l'écosystème Java moderne, notamment le support des threads virtuels pour Java 21, et une flexibilité de journalisation améliorée grâce à SLF4 J. Apache5HttpClient sera remplacé en ApacheHttpClient tant que client synchrone par défaut dans une future version du AWS SDK pour Java 2.x. ApacheHttpClient Il possède une API et des fonctionnalités identiques, ce qui le rend idéal comme remplacement immédiat. Pour plus d'informations sur la configuration duApache5HttpClient, consultezConfiguration du client HTTP basé sur Apache 5.x.

Clients asynchrones

Les clients HTTP asynchrones du SDK for Java implémentent l'interface. SdkAsyncHttpClient Un client de service asynchrone, tel que le S3AsyncClient ou leDynamoDbAsyncClient, nécessite l'utilisation d'un client HTTP asynchrone. AWS SDK pour Java Il propose deux clients HTTP asynchrones.

NettyNioAsyncHttpClient (par défaut)

NettyNioAsyncHttpClientest le client HTTP par défaut utilisé par les clients asynchrones. Pour plus d'informations sur la configuration duNettyNioAsyncHttpClient, consultezConfiguration du client HTTP basé sur Netty.

AwsCrtAsyncHttpClient

AwsCrtAsyncHttpClientIl est basé sur le client HTTP AWS Common Runtime (CRT). Pour plus d'informations sur la configuration duAwsCrtAsyncHttpClient, consultezConfiguration de clients AWS HTTP basés sur CRT.

Recommandations relatives aux clients HTTP

Plusieurs facteurs entrent en jeu lorsque vous choisissez une implémentation de client HTTP. Utilisez les informations suivantes pour vous aider à prendre une décision.

Comparaison des clients HTTP

Le tableau suivant fournit des informations détaillées pour chaque client HTTP.

Client HTTP Synchronisation ou asynchrone Quand l’utiliser Limitation/inconvénient
Client HTTP basé sur Apache

(client HTTP de synchronisation par défaut)

 Sync Utilisez-le si vous préférez une faible latence à un débit élevé Temps de démarrage plus lent par rapport aux autres clients HTTP
Client HTTP basé sur URLConnection Sync Utilisez-le si vous avez une obligation stricte de limiter les dépendances avec des tiers

• Ne prend pas en charge la méthode HTTP PATCH, requise par certaines opérations APIs comme Amazon APIGateway Update

• Ne prend pas en charge un délai d'inactivité configurable. Voir Configurer le client HTTP URLConnection basé pour plus de détails.
AWS Client HTTP de synchronisation basé sur CRT 1 Sync

• Utilisez-le si votre application s'exécute dans AWS Lambda

• Utilisez-le si vous préférez un débit élevé à une faible latence

• Utilisez-le si vous préférez les clients du SDK de synchronisation

Les propriétés système Java suivantes ne sont pas prises en charge :

  • Javax.net, SSL, KeyStore

  • javax.net.ssl. keyStorePassword

  • javax.net .ssl.TrustStore

  • javax.net.ssl. trustStorePassword
Client HTTP basé sur Netty

(client HTTP asynchrone par défaut)

 Asynchrone

• Utilisez-le si votre application s'appuie sur les propriétés du système Java pour la configuration TLS (telles quejavax.net.ssl.keyStore)

 Temps de démarrage plus lent par rapport aux autres clients HTTP
AWS Client HTTP asynchrone basé sur CRT 1 Asynchrone

• Utilisez-le si votre application s'exécute dans AWS Lambda

• Utilisez-le si vous préférez un débit élevé à une faible latence

• Utilisez-le si vous préférez les clients SDK asynchrones

Les propriétés système Java suivantes ne sont pas prises en charge :

  • Javax.net, SSL, KeyStore

  • javax.net.ssl. keyStorePassword

  • javax.net .ssl.TrustStore

  • javax.net.ssl. trustStorePassword

1 En raison de leurs avantages supplémentaires, nous vous recommandons d'utiliser les clients HTTP AWS basés sur CRT si possible.

Paramètres de configuration intelligents par défaut

La AWS SDK for Java 2.x (version 2.17.102 ou ultérieure) propose une fonctionnalité de configuration intelligente par défaut. Cette fonctionnalité optimise deux propriétés du client HTTP ainsi que d'autres propriétés qui n'affectent pas le client HTTP.

Les paramètres par défaut de configuration intelligente définissent des valeurs raisonnables pour les tlsNegotiationTimeoutInMillis propriétés connectTimeoutInMillis et en fonction de la valeur du mode par défaut que vous fournissez. Vous choisissez la valeur du mode par défaut en fonction des caractéristiques de votre application.

Pour plus d'informations sur les paramètres de configuration intelligents par défaut et sur la manière de choisir la valeur de mode par défaut la mieux adaptée à vos applications, consultez le guide de référence AWS SDKs and Tools.

Voici quatre méthodes pour définir le mode par défaut de votre application.

Service client

Utilisez le générateur de client de service pour configurer le mode par défaut directement sur le client de service. L'exemple suivant définit le mode par défaut sur auto pour leDynamoDbClient.

DynamoDbClient ddbClient = DynamoDbClient.builder()
                            .defaultsMode(DefaultsMode.AUTO)
                            .build();
System property

Vous pouvez utiliser la propriété aws.defaultsMode système pour définir le mode par défaut. Si vous définissez la propriété système en Java, vous devez définir la propriété avant d'initialiser un client de service.

L'exemple suivant montre comment définir le mode par défaut à l'autoaide d'une propriété système définie en Java.

System.setProperty("aws.defaultsMode", "auto");

L'exemple suivant montre comment définir le mode par défaut à auto l'aide d'une -D option de la java commande.

java -Daws.defaultsMode=auto
Environment variable

Définissez une valeur pour la variable AWS_DEFAULTS_MODE d'environnement afin de sélectionner le mode par défaut pour votre application.

Les informations suivantes indiquent la commande à exécuter pour définir la valeur du mode par défaut à l'autoaide d'une variable d'environnement.

Système d’exploitation Commande pour définir les variables d'environnement

Linux, macOS ou Unix

 export AWS_DEFAULTS_MODE=auto

Windows

 set AWS_DEFAULTS_MODE=auto
AWS config file

Vous pouvez ajouter une propriété defaults_mode de configuration au AWS config fichier partagé, comme le montre l'exemple suivant.

[default]
defaults_mode = auto

Si vous définissez le mode par défaut globalement avec la propriété système, la variable d'environnement ou le fichier de AWS configuration, vous pouvez remplacer les paramètres lorsque vous créez un client HTTP.

Lorsque vous créez un client HTTP avec httpClientBuilder() cette méthode, les paramètres s'appliquent uniquement à l'instance que vous créez. Vous en trouverez un exemple ici. Dans cet exemple, le client HTTP basé sur Netty remplace toutes les valeurs de mode par défaut définies globalement pour et. connectTimeoutInMillis tlsNegotiationTimeoutInMillis