Spécifier des dépendances

L'environnement d'exécution Java sur l'environnement flexible App Engine permet d'utiliser toutes les bibliothèques compatibles avec Java. Ces instructions s'appuient sur Apache Maven pour créer, exécuter et déployer un exemple d'application utilisant la version 8 et la version 11/17 de l'environnement d'exécution Java. Notez que vous devez mettre à jour votre fichier app.yaml pour utiliser la nouvelle version. Pour en savoir plus sur l'utilisation des nouveaux environnements d'exécution, consultez la page Environnement d'exécution Java. Pour en savoir plus sur l'installation de Maven, consultez la page Utiliser Apache Maven et le plug-in App Engine.

Déclarer et gérer les dépendances

Vous devez spécifier les dépendances dans la section <dependencies> du fichier pom.xml de votre projet afin de les gérer à l'aide de Maven.

Pour gérer la dépendance de votre projet sur Maven, vous pouvez utiliser le wrapper Maven. Si vous n'utilisez pas le wrapper Maven, App Engine utilise par défaut une version récente de Maven lors de l'exécution de gcloud app deploy.

Spécifier la bibliothèque de servlets Java

Les applications Eclipse, Jetty et Tomcat nécessitent la bibliothèque de servlets Java. Précisez-le dans l'entrée <dependencies> du fichier pom.xml :

version 11/17

<dependency>
  <groupId>com.example.appengine</groupId>
  <artifactId>simple-jetty-main</artifactId>
  <version>1</version>
  <scope>provided</scope>
</dependency>

version 8

<dependencies>

  <dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>3.1.0</version>
    <type>jar</type>
    <scope>provided</scope>
  </dependency>

</dependencies>

Notez que des frameworks tels que SparkJava et Spring Boot ne nécessitent pas la bibliothèque de servlets.

Utiliser les bibliothèques clientes Cloud

Les bibliothèques clientes Cloud pour Java fournissent un accès idiomatique aux services Google Cloud. Pour utiliser une bibliothèque, déclarez-la en tant que dépendance.

En règle générale, vous ne pouvez déclarer des dépendances que pour les bibliothèques dont votre application a besoin. Par exemple, pour utiliser la bibliothèque Cloud Storage :

<!--  Using libraries-bom to manage versions.
See https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM -->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.28.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-storage</artifactId>
  </dependency>
</dependencies>

Vous pouvez configurer les bibliothèques clientes Cloud pour Java afin de gérer l'authentification automatiquement.