Configurer Objectify lors de l'exécution locale d'applications

Remarque :Cloud Tools for Eclipse n'est compatible qu'avec l'environnement d'exécution App Engine Java 8, dont la fin de compatibilité expirera le 31 janvier 2024. Après cette date, vos applications Java 8 existantes continueront à fonctionner et à recevoir du trafic. Toutefois, vous ne pourrez pas déployer de nouvelles applications ou mettre à jour celles que vous possédez déjà qui utilisent des environnements d'exécution après leur date de fin de prise en charge. Nous vous recommandons de migrer vers la dernière version compatible de Java.

Objectify est une bibliothèque tierce permettant l'interfaçage avec Datastore à partir d'applications Java. Cloud Tools for Eclipse permet aux utilisateurs d'ajouter Objectify, ainsi que d'autres bibliothèques Google Cloud à leurs projets.

Ce document explique comment configurer Cloud Tools for Eclipse afin de permettre l'utilisation d'Objectify lors de l'exécution locale de votre application.

Configurer Eclipse

Pour configurer Cloud Tools for Eclipse afin d'utiliser Objectify, procédez comme suit :

1. Dans Eclipse, sélectionnez Run > Run Configurations (Exécuter > Exécuter les configurations).

2. Dans la boîte de dialogue Run Configurations (Exécuter les configurations), sélectionnez une configuration de lancement App Engine Local Server (Serveur local App Engine) existante, ou cliquez sur le bouton New launch configuration (Nouvelle configuration de lancement) afin d'en créer une.

3. Sélectionnez l'onglet Cloud Platform de votre configuration d'exécution.

4. Sélectionnez un compte.

5. Sélectionnez un projet afin d'attribuer un ID de projet à utiliser lors de l'exécution locale. Peu importe le projet que vous sélectionnez, car vous ne vous y connecterez pas réellement.

   1. Si vous n'êtes pas connecté ou si vous n'avez pas de projet Cloud, vous pouvez également définir la variable d'environnement GOOGLE_CLOUD_PROJECT sur une valeur de chaîne légale, telle que MyProjectId, dans l'onglet Environment (Environnement) de la configuration d'exécution.

Changer d'émulateur Datastore

Il se peut qu'Objectify 6 rencontre un problème avec l'émulateur Datastore intégré de l'élément dev_appserver, mais la bibliothèque est compatible avec la version bêta de l'émulateur Datastore basé sur gcloud.

Pour utiliser l'émulateur basé sur gcloud, procédez comme suit :

1. Lancez un terminal et exécutez la commande suivante :

   gcloud beta emulators datastore start
   

2. Au démarrage de l'émulateur, un message s'affiche comme suit :

   [datastore] API endpoint: http://localhost:8081
   [datastore] If you are using a library that supports the DATASTORE_EMULATOR_HOST environment variable, run:
   [datastore]
   [datastore]   export DATASTORE_EMULATOR_HOST=localhost:8081
   [datastore]
   [datastore] Dev App Server is now running.
   

3. Dans Eclipse, ajoutez la variable d'environnement DATASTORE_EMULATOR_HOST à votre configuration d'exécution dans l'onglet Environment (Environnement).

   1. Dans cet exemple, définissez son nom sur DATASTORE_EMULATOR_HOST et sa valeur sur localhost:8081.

   Si vous utilisez l'émulateur Datastore basé sur gcloud, aucune donnée ne s'affiche sur la page d'administration Datastore pour l'élément dev_appserver local.

Étapes suivantes

• Explorez le code du plug-in ou signalez des problèmes sur GitHub, ou posez une question sur Stack Overflow.