View a markdown version of this page

Travaillez avec Amazon S3 - AWS SDK for Java 2.x
Clients S3 dans le SDK

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.

Travaillez avec Amazon S3

Cette section fournit des informations générales sur l'utilisation d'Amazon S3 à l'aide du AWS SDK for Java 2.x. Cette section complète les exemples Java v2 d'Amazon S3 présentés dans la section Exemples de code de ce guide.

clients S3 dans le AWS SDK for Java 2.x

AWS SDK for Java 2.x fournit différents types de clients S3. Le tableau suivant montre les différences et peut vous aider à déterminer ce qui convient le mieux à vos cas d'utilisation.

Différents types de clients Amazon S3
Client S3 Description abrégée Quand l’utiliser Limitation/drawback

AWS CRT-based Client S3

Interface : S3AsyncClient

Constructeur : S3CrtAsyncClientBuilder

  • Fournit les mêmes opérations d'API asynchrones que le client asynchrone Java-based S3, mais avec de meilleures performances.

  • Nécessite la aws-crt dépendance.

  • Supporte les transferts parallèles automatiques (multipart).

Consultez Utiliser un client S3 performant : client S3 AWS basé sur CRT.

  • Votre application transfère des objets volumineux (> 8 Mo) et vous souhaitez optimiser les performances.

  • Vous souhaitez télécharger des objets dont la longueur du contenu est inconnue.

  • Vous souhaitez améliorer le regroupement des connexions et l'équilibrage de charge DNS, afin d'améliorer le débit et les performances.

  • Vous souhaitez améliorer la fiabilité des transferts en cas de panne du réseau. Les pièces défectueuses individuelles sont réessayées sans recommencer le transfert depuis le début.

Java-based Client asynchrone S3 avec multipartie activé

Interface : S3AsyncClient

Constructeur : S3AsyncClientBuilder

  • Fournit une API asynchrone.

  • Prend en charge les transferts parallèles automatiques (multipart) lorsque vous activez le multipart au moment de la création.

Consultez Configurer le client asynchrone S3 basé sur Java pour utiliser les transferts parallèles.

  • Votre application transfère des objets volumineux et vous souhaitez améliorer les performances.

  • vous souhaitez télécharger un objet dont la longueur du contenu est inconnue.

  • Vous souhaitez améliorer la fiabilité des transferts en cas de panne du réseau. Les pièces défectueuses individuelles sont réessayées sans recommencer le transfert depuis le début.

  • Vous avez besoin d'options de configuration qui ne sont pas disponibles avec le client AWS CRT-based S3.

 Moins performant que le client AWS CRT-based S3.

Java-based Client asynchrone S3 sans multipartie activé

Interface : S3AsyncClient

Constructeur : S3AsyncClientBuilder

  • Fournit une API asynchrone.

  • Vous transférez des objets dont la taille est inférieure à 8 Mo.

  • Vous voulez une API asynchrone.

Aucune optimisation des performances.

Java-based Client de synchronisation S3

Interface : S3 Client

Constructeur : S3ClientBuilder

  • Fournit une API synchrone.

  • Vous transférez des objets dont la taille est inférieure à 8 Mo.

  • Vous voulez une API synchrone.

Aucune optimisation des performances.
Note

À partir de la version 2.18.x, l'adressage de type hébergé virtuel est AWS SDK for Java 2.x utilisé pour inclure un remplacement du point de terminaison. Cela s'applique tant que le nom du bucket est une étiquette DNS valide.

Appelez la forcePathStyleméthode true dans votre générateur de clients pour forcer le client à utiliser un adressage de type chemin pour les buckets.

L'exemple suivant montre un client de service configuré avec un remplacement de point de terminaison et utilisant un adressage de type chemin.

S3Client client = S3Client.builder()
                          .region(Region.US_WEST_2)
                          .endpointOverride(URI.create("https://s3.us-west-2.amazonaws.com"))
                          .forcePathStyle(true)
                          .build();
Rubriques