Créer votre première fonction Java dans Azure à l’aide d’IntelliJ

Cet article explique comment utiliser Java et IntelliJ pour créer une fonction Azure.

Plus précisément, cet article vous montre :

• Comment créer une fonction Java déclenchée par HTTP dans un projet IntelliJ IDEA
• Les étapes pour tester et déboguer le projet dans l’environnement de développement intégré (IDE) sur votre ordinateur
• Les instructions pour déployer le projet de fonction sur Azure Functions

Prérequis

• Compte Azure avec un abonnement actif. Créez un compte gratuitement.
• Un kit de développement Java (JDK) pris en charge par Azure, version 8, 11, 17 ou 21. (Java 21 est actuellement pris en charge en préversion sur Linux uniquement)
• IntelliJ IDEA Ultimate Edition ou Community Edition
• Maven 3.5.0 (ou version supérieure)
• La dernière version de Functions Core Tools

Installer le plug-in et se connecter

Pour installer Azure Toolkit for IntelliJ puis vous connecter, procédez comme suit :

1. Dans la boîte de dialogue Paramètres/Préférences d’IntelliJ IDEA (Ctrl+Alt+S), sélectionnez Plug-ins. Recherchez ensuite Azure Toolkit for IntelliJ dans la Place de marché, puis sélectionnez Installer. Une fois l’installation effectuée, sélectionnez Redémarrer pour activer le plug-in.

   

2. Pour vous connecter à votre compte Azure, ouvrez la barre latérale Azure Explorer, puis sélectionnez l’icône Connexion à Azure dans la barre du haut (ou dans le menu IDEA, sélectionnez Outils > Azure > Connexion à Azure).

   

3. Dans la fenêtre Connexion à Azure, sélectionnez OAuth 2.0, puis sélectionnez Se connecter. Pour d’autres options de connexion, consultez Instructions de connexion pour Azure Toolkit for IntelliJ.

   

4. Dans le navigateur, connectez-vous avec votre compte, puis revenez à IntelliJ. Dans la boîte de dialogue Sélectionner des abonnements, sélectionnez les abonnements à utiliser, puis choisissez Sélectionner.

   

Créer votre projet local

Pour utiliser Azure Toolkit for IntelliJ afin de créer un projet Azure Functions local, procédez comme suit :

1. Ouvrez la boîte de dialogue Bienvenue d’Open IntelliJ IDEA, sélectionnez Nouveau projet pour ouvrir l’Assistant de création de projet, puis sélectionnez Azure Functions.

   

2. Sélectionnez Déclencheur HTTP, sélectionnez Suivant, puis suivez l’Assistant pour passer en revue toutes les configurations dans les pages suivantes. Vérifiez l’emplacement de votre projet, puis sélectionnez Terminer. IntelliJ IDEA ouvre ensuite votre nouveau projet.

   

Exécutez le projet localement.

Pour exécuter le projet localement, procédez comme suit :

1. Accédez à src/main/java/org/example/functions/HttpTriggerJava.java pour voir le code généré. À côté de la ligne 17, vous devez voir un bouton vert Exécuter. Sélectionnez-le, puis choisissez Exécuter « Functions-azur... ». Vous devez voir votre application de fonction s’exécuter localement avec quelques journaux.

   

   

2. Vous pouvez essayer la fonction en accédant au point de terminaison affiché à partir du navigateur, comme http://localhost:7071/api/HttpTriggerJava?name=Azure.

   

3. Le journal s’affiche également dans votre IDEA. Arrêtez l’application de fonction en sélectionnant Arrêter.

   

Déboguer le projet localement

Pour déboguer le projet localement, procédez comme suit :

1. Sélectionnez le bouton Déboguer de la barre d’outils. Si vous ne voyez pas la barre d’outils, activez-la en choisissant View>Appearance>Toolbar (Afficher > Apparence > Barre d’outils).

   

2. Sélectionnez la ligne 20 du fichier src/main/java/org/example/functions/HttpTriggerJava.java pour ajouter un point d’arrêt. Accédez à nouveau au point de terminaison http://localhost:7071/api/HttpTriggerJava?name=Azure. Vous constaterez que le point d’arrêt a été atteint. Vous pouvez ensuite essayer d’autres fonctionnalités de débogage telles que Step, Watch et Evaluation. Arrêtez la session de débogage en sélectionnant Arrêter.

   

Créer l’application de fonction dans Azure

Pour créer une application de fonction et les ressources associées dans votre abonnement Azure, suivez les étapes ci-après :

1. Dans l’Explorateur Azure, au sein de votre IDEA, cliquez avec le bouton droit sur Application de fonction, puis sélectionnez Créer.

2. Sélectionnez Plus de paramètres, puis indiquez les informations suivantes aux invites :

   Prompt	Sélection
   Abonnement	choisissez l’abonnement à utiliser.
   Groupe de ressources	Choisissez le groupe de ressources de votre application de fonction.
   Nom	Spécifiez le nom d’une nouvelle application de fonction. Ici, nous pouvons simplement accepter la valeur par défaut.
   Plateforme	Sélectionnez Windows-Java 17 ou une autre plateforme, selon le cas.
   Région	Pour de meilleures performances, choisissez une région proche de vous.
   Options d’hébergement	Choisissez les options d’hébergement de votre application de fonction.
   Planifier	Choisissez le niveau tarifaire du plan App Service à utiliser, ou sélectionnez + pour créer un plan App Service.

   Important

   Pour créer votre application dans le plan de consommation flexible, sélectionnez Consommation flexible. Le plan Consommation flexible est actuellement en préversion.

3. Cliquez sur OK. Une notification s’affiche une fois votre application de fonction créée.

Déployer votre projet sur Azure

Pour déployer votre projet sur Azure, procédez comme suit :

1. Sélectionnez et développez l’icône Azure dans l’Explorateur de projets IntelliJ, puis sélectionnez Déployer sur Azure -> Déployer sur Azure Functions.

   

2. Vous pouvez sélectionner l’application de fonction de la section précédente. Pour en créer une autre, sélectionnez + sur la ligne Fonction. Tapez le nom de l’application de fonction, puis choisissez la plateforme appropriée. Ici, vous pouvez accepter la valeur par défaut. Sélectionnez OK. La nouvelle application de fonction que vous avez créée est automatiquement sélectionnée. Sélectionnez Exécuter pour déployer vos fonctions.

   

   

Gérer les applications de fonction à partir d’IDEA

Pour gérer vos applications de fonction avec Azure Explorer dans votre IDEA, procédez comme suit :

1. Sélectionnez Application de fonction pour voir la liste de toutes vos applications de fonction.

   

2. Sélectionnez l’une de vos applications de fonction, puis cliquez avec le bouton droit, et sélectionnez Afficher les propriétés pour ouvrir la page de détails.

   

3. Cliquez avec le bouton droit sur votre application de fonction HttpTrigger-Java, puis sélectionnez Déclencher la fonction dans le navigateur. Vous verrez que le navigateur est ouvert avec l’URL du déclencheur.

   

Ajouter des fonctions au projet

Pour ajouter plus de fonctions à votre projet, procédez comme suit :

1. Cliquez avec le bouton droit sur le package org.example.functions, puis sélectionnez Nouveau -> Classe de fonction Azure.

   

2. Renseignez le nom de la classe HttpTest, sélectionnez HttpTrigger dans l’Assistant Création de classe de fonction, puis sélectionnez OK pour effectuer la création. Vous pouvez ainsi créer des fonctions comme vous le souhaitez.

   

   

Nettoyage des fonctions

Sélectionnez l’une de vos applications de fonction à l’aide d’Azure Explorer dans votre IDEA, puis cliquez avec le bouton droit et sélectionnez Supprimer. L’exécution de cette commande peut prendre plusieurs minutes. Une fois l’opération effectuée, l’état est actualisé dans l’Azure Explorer.

Étapes suivantes

Vous avez créé un projet Java avec une fonction déclenchée par HTTP, l’avez exécuté sur votre ordinateur local et l’avez déployée sur Azure. À présent, étendez votre fonction en continuant à l’article suivant :