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.

Objectifs

  • Installer un JDK (kit de développement Java)
  • Installer un outil de compilation automatique
  • (Facultatif) Installer un IDE ou un éditeur
  • (Facultatif) Installer le plug-in IDE du SDK Cloud
  • 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ètement du code et les fonctions de débogage entièrement intégrées.

(Facultatif) Installer le plug-in IDE du SDK Cloud

Pour accéder à des fonctions utiles de votre éditeur, découvrez les plug-ins sponsorisés par Google pour Eclipse ou IntelliJ.

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>10.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 :

compile 'com.google.cloud:google-cloud-bigquery:1.117.1'

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

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

Si vous utilisez 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

Ajoutez le plug-in Maven App Engine ou Gradle pour environnement App Engine standard.

Pour les environnements App Engine flexibles

Ajoutez le plug-in Maven App Engine ou Gradle pour environnement App Engine flexible.

Autres ressources