Configurer un environnement de développement Java

Ce tutoriel explique comment préparer votre machine locale pour le développement Java, y compris le développement d'applications Java s’exécutant sur Google  Cloud. Suivez-le pour installer Java et les outils pertinents.

Conseil: Si vous souhaitez commencer rapidement, l'éditeur Cloud Shell est compatible avec l'IDE pour le cycle de développement complet des applications Kubernetes et Cloud Run. L'éditeur Cloud Shell est basé sur la plate-forme IDE Eclipse Theia. Il comprend les outils Cloud SDK et Cloud Code préinstallés.

Objectifs

  • Installer un JDK (kit de développement Java)
  • Installer un outil de compilation automatique
  • (Facultatif) Installer un IDE ou un éditeur
  • (Facultatif) Installez le plug-in du SDK Cloud IDE.
  • (Facultatif) Installez le plug-in du framework des fonctions.
  • Installer le SDK Cloud
  • Installer la bibliothèque cliente Google Cloud pour Java

Installer un JDK (kit de développement Java)

Installer une distribution OpenJDK 11 ou OpenJDK 8 Vous trouverez ci-dessous une liste non exhaustive de distributions que vous pouvez utiliser :

  • SdkMan : outil permettant de gérer plusieurs SDK, y compris de nombreux SDK OpenJDK, Maven et Gradle.
  • AdoptOpenJDK : builds OpenJDK créés par RedHat.
  • Builds de la communauté Zulu : builds OpenJDK de la communauté Zulu.
  • jdk.java.net : builds du kit de développement Java (JDK), créés par Oracle.

Assurez-vous que les variables d'environnement suivantes sont définies :

  • JAVA_HOME : pointe vers la base de l'installation du JDK.
  • PATH : inclut $JAVA_HOME/bin.

Installer un outil de compilation automatique

Apache Maven, Gradle et SBT sont des options de gestion de packages permettant de créer rapidement et systématiquement des dépendances d'applications Java sur toutes les plates-formes.

Installer le SDK Cloud

Le SDK Cloud est un ensemble d'outils associé à Google Cloud. Il contient gcloud, gsutil et bq, qui vous permettent d'accéder à Compute Engine, Cloud Storage, BigQuery et à d'autres produits et services à partir de la ligne de commande. Vous pouvez exécuter ces outils de façon interactive ou dans des scripts automatisés.

(Facultatif) Installer un IDE ou un éditeur

Voici une liste non exhaustive d'éditeurs courants permettant de développer des applications Java (sans ordre particulier) :

Ces éditeurs, parfois accompagnés de plug-ins, contiennent de nombreuses fonctionnalités, telles que la coloration syntaxique, IntelliSense, le complément du code et les fonctions de débogage entièrement intégrées.

(Facultatif) Installer un plug-in IDE

Pour accéder aux fonctions utiles de votre éditeur, consultez les plug-ins suivants:

(Facultatif) Installer le plug-in du framework des fonctions

Le plug-in du framework des fonctions vous permet d'exécuter et de tester des fonctions Java sur votre ordinateur local.

Si vous utilisez Apache Maven, ajoutez les éléments suivants à votre fichier pom.xml:

<dependency>
  <groupId>com.google.cloud.functions</groupId>
  <artifactId>functions-framework-api</artifactId>
  <version>1.0.1</version>
  <scope>provided</scope>
</dependency>

Si vous utilisez Gradle, ajoutez les lignes suivantes à votre fichier build.gradle:

dependencies {
  implementation 'com.google.cloud.functions:functions-framework-api:1.0.1'
}

Utiliser la bibliothèque cliente Google Cloud pour Java

Utilisez la bibliothèque cliente Google Cloud pour Java pour réaliser l'intégration aux services Google Cloud, tels que Datastore et Cloud Storage. Vous pouvez installer le package pour une API individuelle, telle que BigQuery, comme indiqué dans l'exemple suivant.

Installer la bibliothèque cliente

Si vous utilisez Maven, ajoutez les lignes suivantes à votre fichier pom.xml. Pour en savoir plus sur les BOM, consultez la page The Google Cloud Platform Libraries BOM (BOM des bibliothèques Google Cloud Platform).

<!--  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>23.0.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

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

Si vous utilisez Gradle, ajoutez les éléments suivants à vos dépendances :

implementation platform('com.google.cloud:libraries-bom:23.0.0')

implementation 'com.google.cloud:google-cloud-bigquery'

Si vous utilisez sbt, ajoutez les éléments suivants à vos dépendances :

libraryDependencies += "com.google.cloud" % "google-cloud-bigquery" % "2.1.7"

Si vous utilisez Visual Studio Code, IntelliJ ou Eclipse, vous pouvez ajouter des bibliothèques clientes à votre projet à l'aide des plug-ins IDE suivants :

Les plug-ins offrent des fonctionnalités supplémentaires, telles que la gestion des clés pour les comptes de service. Reportez-vous à la documentation de chaque plug-in pour plus de détails.

Configurer l'authentification

Pour exécuter la bibliothèque cliente, vous devez d'abord configurer l'authentification.

Utiliser la bibliothèque cliente

// Imports the Google Cloud client library
import com.google.cloud.bigquery.BigQuery;
import com.google.cloud.bigquery.BigQueryOptions;
import com.google.cloud.bigquery.Dataset;
import com.google.cloud.bigquery.DatasetInfo;

public class QuickstartSample {
  public static void main(String... args) throws Exception {
    // Instantiate a client. If you don't specify credentials when constructing a client, the
    // client library will look for credentials in the environment, such as the
    // GOOGLE_APPLICATION_CREDENTIALS environment variable.
    BigQuery bigquery = BigQueryOptions.getDefaultInstance().getService();

    // The name for the new dataset
    String datasetName = "my_new_dataset";

    // Prepares a new dataset
    Dataset dataset = null;
    DatasetInfo datasetInfo = DatasetInfo.newBuilder(datasetName).build();

    // Creates the dataset
    dataset = bigquery.create(datasetInfo);

    System.out.printf("Dataset %s created.%n", dataset.getDatasetId().getDataset());
  }
}

Étape suivante

(Facultatif) Utiliser le plug-in Maven ou Gradle pour App Engine

Si vous exploitez l'environnement App Engine standard ou flexible, vous pouvez utiliser des plug-ins pour les outils de compilation Apache Maven et Gradle, qui fournissent des fonctions pratiques pour développer, tester et déployer vos applications directement.

Pour les environnements App Engine standards

Utilisez le plug-in Maven App Engine ou Gradle pour les environnements standards App Engine.

Pour les environnements App Engine flexibles

Utilisez le plug-in Maven App Engine ou Gradle pour les environnements flexibles App Engine.

Autres ressources