La version AWS SDK pour Java 1.x a atteint la fin du support le 31 décembre 2025. Nous vous recommandons de migrer vers le pour continuer AWS SDK for Java 2.x à bénéficier des nouvelles fonctionnalités, des améliorations de disponibilité et des mises à jour de sécurité.

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.

Bonnes pratiques pour AWS Développement avec le AWS SDK pour Java

Les bonnes pratiques suivantes peuvent vous aider à éviter les problèmes lors du développement d' AWS applications avec le AWS SDK pour Java. Nous avons organisé les bonnes pratiques par service.

S3

Éviter ResetExceptions

Lorsque vous chargez des objets à Amazon S3 l'aide de flux (via un AmazonS3 client ouTransferManager), vous pouvez rencontrer des problèmes de connectivité réseau ou de temporisation. Par défaut, les AWS SDK pour Java tentatives de nouvelle tentative de transfert ont échoué en marquant le flux d'entrée avant le début du transfert, puis en le réinitialisant avant de réessayer.

Si le flux ne prend pas en charge le marquage et la réinitialisation, le SDK lance un message en ResetException cas d'échecs transitoires et que les nouvelles tentatives sont activées.

Bonne pratique

Nous vous recommandons d'utiliser des flux qui prennent en charge les opérations de marquage et de réinitialisation.

Le moyen le plus fiable d'éviter a ResetException est de fournir des données à l'aide d'un fichier ou FileInputStream, qu'ils AWS SDK pour Java peuvent gérer sans être contraints par des limites de marquage et de réinitialisation.

Si le flux n'est pas un FileInputStream mais qu'il prend en charge le marquage et la réinitialisation, vous pouvez définir la limite de marquage en utilisant la setReadLimit méthode de RequestClientOptions. Sa valeur par défaut est 128 Ko. La définition de la valeur limite de lecture à un octet supérieur à la taille du flux évitera de manière fiable un ResetException.

Par exemple, si la taille maximale attendue d'un flux est 100 000 octets, définissez la limite de lecture sur 100 001 (100 000 + 1) octets. Le marquage et la réinitialisation fonctionneront toujours pour 100 000 octets ou moins. Ayez à l'esprit que cela peut entraîner le fait que certains flux mettent en mémoire tampon le nombre d'octets en mémoire.