aws sdk java v2

Kit SDK AWS pour Java 2.0

Le kit AWS SDK pour Java 2.0 est une réécriture de la version 1.0 avec de nouvelles fonctionnalités intéressantes. Comme avec la version 1.0, il vous permet de travailler facilement avec Amazon Web Services, mais inclut également des fonctionnalités telles que les E/S non bloquantes et l'implémentation HTTP enfichable pour personnaliser davantage vos applications. Vous pouvez démarrer en quelques minutes en utilisant Maven ou tout autre système de build prenant en charge MavenCentral comme source d'artefact.

• Page d'accueil du SDK
• Journal des modifications 1.11 à 2.0
• Meilleures pratiques
• Exemple de code
• Documentation sur l'API
• Guide du développeur (source)
• Archétypes Maven
• Problèmes
• Blogue SDK
• Donner des commentaires

Commencer

Inscrivez-vous à AWS

Avant de commencer, vous avez besoin d'un compte AWS. Veuillez consulter la section S'inscrire à AWS du guide du développeur pour plus d'informations sur la façon de créer un compte AWS et de récupérer vos informations d'identification AWS.

Exigences minimales

Pour exécuter le SDK, vous aurez besoin de Java 1.8+ . Pour plus d'informations sur la configuration requise et les paramètres optimaux pour le SDK, veuillez consulter la section Installation d'un environnement de développement Java du guide du développeur.

Utiliser le SDK

La méthode recommandée pour utiliser le kit AWS SDK for Java dans votre projet consiste à l'utiliser depuis Maven Central.

Importer la nomenclature

Pour gérer automatiquement les versions des modules (actuellement tous les modules ont la même version, mais ce n'est pas toujours le cas), nous vous recommandons d'utiliser l'import de nomenclature comme suit :

< dependencyManagement >
  < dependencies >
    < dependency >
      < groupId >software.amazon.awssdk</ groupId >
      < artifactId >bom</ artifactId >
      < version >2.29.31</ version >
      < type >pom</ type >
      < scope >import</ scope >
    </ dependency >
  </ dependencies >
</ dependencyManagement >

Ensuite, les modules individuels peuvent omettre la version de leur déclaration de dépendance :

< dependencies >
  < dependency >
    < groupId >software.amazon.awssdk</ groupId >
    < artifactId >ec2</ artifactId >
  </ dependency >
  < dependency >
    < groupId >software.amazon.awssdk</ groupId >
    < artifactId >s3</ artifactId >
  </ dependency >
  < dependency >
    < groupId >software.amazon.awssdk</ groupId >
    < artifactId >dynamodb</ artifactId >
  </ dependency >
</ dependencies >

Services individuels

Vous pouvez également ajouter des dépendances pour les services spécifiques que vous utilisez uniquement :

< dependency >
  < groupId >software.amazon.awssdk</ groupId >
  < artifactId >ec2</ artifactId >
  < version >2.29.31</ version >
</ dependency >
< dependency >
  < groupId >software.amazon.awssdk</ groupId >
  < artifactId >s3</ artifactId >
  < version >2.29.31</ version >
</ dependency >

SDK complet

Vous pouvez importer l'intégralité du SDK dans votre projet (inclut TOUS les services). Veuillez noter qu'il est recommandé de n'importer que les modules dont vous avez besoin.

< dependency >
  < groupId >software.amazon.awssdk</ groupId >
  < artifactId >aws-sdk-java</ artifactId >
  < version >2.29.31</ version >
</ dependency >

Consultez la section Configurer le kit AWS SDK pour Java du guide du développeur pour plus d'informations sur l'utilisation.

Nouvelles fonctionnalités pour 2.0

• Fournit un moyen de connecter votre propre implémentation HTTP.

• Fournit une prise en charge de première classe pour les E/S non bloquantes dans les clients asynchrones.

Construire à partir de la source

Une fois que vous avez extrait le code de GitHub, vous pouvez le créer à l'aide des commandes suivantes.

Linux :

./mvnw clean install

# Skip tests, checkstyles, findbugs, etc for quick build
./mvnw clean install -P quick

# Build a specific service module
./mvnw clean install -pl :s3 -P quick --am

Fenêtres :

./mvnw.cmd clean install

Exemple de code

Vous pouvez trouver un exemple de code pour la v2 aux endroits suivants :

• dépôt aws-doc-sdk-examples.
• Tests d'intégration dans ce dépôt. Ils se trouvent dans le répertoire it sous chaque module de service, par exemple : s3-integration-tests

Maintenance et support pour les versions majeures du SDK

Pour plus d'informations sur la maintenance et la prise en charge des versions majeures du SDK et de leurs dépendances sous-jacentes, consultez les informations suivantes dans le Guide de référence des kits SDK et outils AWS :

• Politique de maintenance des kits SDK et des outils AWS
• Matrice de prise en charge des versions des kits SDK et des outils AWS

Maintenance et support des versions Java

Nous maintenons une prise en charge complète des versions LTS (Long-Term Support) : Java 8, Java 11, Java 17 et Java 21. Notez qu'il peut y avoir des fonctionnalités individuelles dans les versions plus récentes qui ne sont pas prises en charge, car le SDK doit être compatible avec Java. 8.

Donner des commentaires

Nous avons besoin de votre aide pour rendre ce SDK génial. Veuillez participer à la communauté et contribuer à cet effort en soumettant des problèmes, en participant à des forums de discussion et en soumettant des demandes de tirage via les canaux suivants :

• Soumettre des problèmes - c'est le canal préféré pour interagir avec notre équipe
• Articulez votre demande de fonctionnalité ou votez pour celles existantes sur notre page Problèmes

Contributeurs

Merci à ces personnes merveilleuses (clé emoji) :

Sullis	Austin Brooks	Konrad `ktoso` Malawski	Andrew Hopkins	Adam Thomas	Steven Swor	Carey Burgess
Anuraag Agrawal	Jeffrey	Boris	Guillaume Corré	Henri Yandell	Ryan Schmitt	Somaya
Steven Aerts	Steven Wong	Tomasz Elendt	Will Erickson	Julien Hoarau	SEOKHYOENCHOI	adrianistor
Soleil de Xian	Andreas Scheja	Anton Egorov	roexber	Brharrington	Christophe Radek	Foivos
Frank Wesemann	Gergély Varga	Guillermo	Henri Heikkinen	Jochen Schalanda	Joe Barnett	Kazuhiro Sera
Krishna Chaithanya Ganta	Lee Packham	Matteo Carrara	Michael Scharp	Miguel Jiménez	Russell Bollés	Russell Scheerer
Scott	Shin'ya Ueoka	sushilamazon	tomliu4uber	Vladimir Orany	Xin Yu Hu	Joseph Fertel
Denys Konakhevych	Alex Weibel	Ryan Carper	Jonathan M. Henson	Débora N. Ito	Bret Ambroise	Anna-Karin Salander
John Viegas	Dongie Agnir	Matthieu Miller	Benjamin Maizels	Quan Zhou	Zoé Wang	Varun Nandi
Andrew Shore	Kyle Thomson	Sam Fink	Jonathan Bond	ajs139	Dewey Nguyen	David Leen
Michael Li	Bennett Lynch	Ikko Ashimine	Jamie Liu	guillepb10	Lorenz Nickel	Erin Yang
Roberto Tyley	Alvin Voir	ron1	Sai Kumar Reddy Chandupatla	David Ho	Thomas Turrell Croft	Steven Shan
Barry O'Neill	Andy Kiesler	Martine	Paul Lieuthier	Sébastien Crocquesel	David Négrete	Stéphane Flavin
Olivier L Applin	Adrien Chlebosz	Chad Wilson	Manish Dait	Denis Kieselhorst	Nilesh PS	Steven Swartz
Michael Dimchuk	Nikita Sokolov	Manuel Sugawara	Anirudh	Hayden Boulanger	Jaykumar Gosar	Michael Graeb
Michael Grundie	Eckard Mühlich	Tobias Solochtchenko	Luis Madrigal	Kirill Tchaïkine	cuves pratek	Fût1155	Thomas Farr

Ce projet suit la spécification de tous les contributeurs. Les contributions de toute nature sont les bienvenues !