La AWS SDK for Java version 1.x est entrée en mode maintenance le 31 juillet 2024 et atteindra end-of-supportle 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.

Utiliser le SDK avec Apache Maven

Vous pouvez utiliser Apache Maven pour configurer et générer des projets AWS SDK for Java ou pour générer le kit SDK lui-même.

Création d'un package Maven

Pour créer un package Maven de base, ouvrez une fenêtre de terminal (ligne de commande) et exécutez :

mvn -B archetype:generate \
  -DarchetypeGroupId=org.apache.maven.archetypes \
  -DgroupId=org.example.basicapp \
  -DartifactId=myapp

Remplacez org.example.basicapp par l'espace de noms complet du package de votre application et myapp par le nom de votre projet (celui-ci devient le nom du répertoire de votre projet).

Par défaut, crée un modèle de projet pour vous à l'aide de l'archétype de démarrage rapide, qui constitue un bon point de départ pour de nombreux projets. D'autres archétypes sont disponibles ; rendez-vous sur la page des archétypes de Maven pour obtenir la liste des archétypes fournis avec. Vous pouvez choisir un archétype particulier à utiliser en ajoutant l'argument -DarchetypeArtifactId à la commande archetype:generate. Par exemple :

mvn archetype:generate \
  -DarchetypeGroupId=org.apache.maven.archetypes \
  -DarchetypeArtifactId=maven-archetype-webapp \
  -DgroupId=org.example.webapp \
  -DartifactId=mywebapp

Configuration du kit SDK en tant que dépendance Maven

Pour utiliser le kit AWS SDK for Java dans votre projet, vous devez le déclarer comme dépendance dans le fichier pom.xml de votre projet. Depuis la version 1.9.0, vous pouvez importer des composants individuels ou l'intégralité du kit SDK.

Spécification individuelle des modules SDK

Pour sélectionner des modules SDK individuels, utilisez la nomenclature Maven du kit AWS SDK for Java, qui garantit que les modules que vous spécifiez recourent à la même version du kit SDK et qu'ils sont compatibles entre eux.

Pour utiliser la nomenclature, ajoutez une section <dependencyManagement> au fichier pom.xml de votre application, en ajoutant aws-java-sdk-bom en tant que dépendance et en spécifiant la version du kit SDK que vous voulez utiliser :

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.amazonaws</groupId>
      <artifactId>aws-java-sdk-bom</artifactId>
      <version>1.11.1000</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

Pour consulter la dernière version de laAWS SDK for Java nomenclature disponible sur Maven Central, rendez-vous sur : https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom. Vous pouvez également utiliser cette page pour savoir quels sont les modules (dépendances) gérés par la nomenclature et que vous pouvez inclure dans la section <dependencies> du fichier pom.xml de votre projet.

Vous pouvez maintenant sélectionner individuellement les modules du kit SDK que vous utilisez dans votre application. Dans la mesure où vous avez déjà déclaré la version du kit SDK dans la nomenclature, il n'est pas nécessaire de spécifier le numéro de version de chaque composant.

<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-s3</artifactId>
  </dependency>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-dynamodb</artifactId>
  </dependency>
</dependencies>

Vous pouvez également vous référer Catalogue d'exemples de code AWSau pour savoir quelles dépendances utiliser pour une donnéeService AWS. Reportez-vous au fichier POM sous un exemple de service spécifique. Par exemple, si vous êtes intéressé par les dépendances du serviceAWS S3, consultez l'exemple complet sur GitHub. (Observez le fichier POM sous /java/example_code/s3).

Importation de tous les modules SDK

Si vous souhaitez enregistrer l'intégralité du kit SDK comme dépendance, n'utilisez pas la méthode de nomenclature, mais déclarez simplement le kit SDK dans votre fichier pom.xml, comme suit :

<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk</artifactId>
    <version>1.11.1000</version>
  </dependency>
</dependencies>

Génération de votre projet

Une fois que vous avez configuré votre projet, vous pouvez le générer à l'aide de la commande Maven package :

mvn package

Cette opération crée votre fichier –0—jar dans le répertoire target.

Génération du kit SDK avec Maven

Vous pouvez utiliser Apache Maven pour générer le kit SDK à partir du code source. Pour ce faire, téléchargez le code du SDK depuis GitHub, décompressez-le localement, puis exécutez la commande Maven suivante :

mvn clean install